| author | Tom Tromey <tom@tromey.com> | 2023年01月29日 12:39:45 -0700 |
|---|---|---|
| committer | Tom Tromey <tom@tromey.com> | 2023年01月29日 13:11:39 -0700 |
| commit | 4b055d298d24bcc306a9923c945c223ada7d8479 (patch) | |
| tree | 0d61a9e6467cc3a6f049d9b82e5fdb3e5041d469 | |
| parent | 3c359056a071fe6d42f367a97902d0f5bb9c75d4 (diff) | |
| download | src-highlite-4b055d298d24bcc306a9923c945c223ada7d8479.tar.gz | |
| -rw-r--r-- | ChangeLog | 9 | ||||
| -rw-r--r-- | doc/source-highlight-lib.texi | 18 | ||||
| -rw-r--r-- | doc/source-highlight.texi | 4 |
@@ -1,5 +1,14 @@ 2023年01月29日 Tom Tromey <tom@tromey.com> + * doc/source-highlight.texi (Introduction): Don't use @inforef. + (Problems): Remove @refill. + * doc/source-highlight-lib.texi (Introduction, Installation) + (SourceHighlight class, Style-based Customized Formatting) + (Settings): Don't use @inforef. + (Problems): Remove @refill. + +2023年01月29日 Tom Tromey <tom@tromey.com> + * configure.ac: Check for makeinfo. 2023年01月29日 Tom Tromey <tom@tromey.com> diff --git a/doc/source-highlight-lib.texi b/doc/source-highlight-lib.texi index 2fb9586..165c2a4 100644 --- a/doc/source-highlight-lib.texi +++ b/doc/source-highlight-lib.texi @@ -127,7 +127,7 @@ This file documents GNU Source-highlight Library version @value{VERSION}. @cindex introduction @cindex features GNU Source-highlight, given a source file, produces a document with -syntax highlighting. @inforef{Introduction,,source-highlight} for a +syntax highlighting. @xref{Introduction,,,source-highlight} for a wider introduction about GNU Source-highlight. This file documents the Library provided by GNU Source-highlight, thus @@ -145,7 +145,7 @@ documentation of GNU Source-highlight for all these features. GNU Source-highlight library is part of GNU Source-highlight, thus it will be installed together with Source-highlight itself; we refer to -@inforef{Installation,,source-highlight} for further instructions on +@xref{Installation,,,source-highlight} for further instructions on installing GNU Source-highlight. Here we detail only the parts concerning the library. @@ -293,8 +293,7 @@ implements all the functionalities used by the program @sourcehighlight{} itself; thus it highlights an input file generating an output file. It can be configured with many options, and basically it has a get/set methods for all the command line options of -@sourcehighlight{} (we refer also to @inforef{Invoking -source-highlight,,source-highlight}). +@sourcehighlight{} (we refer also to @xref{Invoking source-highlight,,,source-highlight}). For instance, the following example (@file{source-highlight-console-main.cpp}) highlights an input file to @@ -427,8 +426,8 @@ symbol: ;, start: 17 Source-highlight can rely on style (and css style) files for generating formatting. Usually, the formatters are built according to the output -format, specified through @file{.outlang} files, @inforef{Output -Language Definitions,,source-highlight}. However, you can also create +format, specified through @file{.outlang} files, +@xref{Language Definitions,,,source-highlight}. However, you can also create your own formatters based on the information of the style file (or css style file). During the parsing of these style files, a @classname{FormatterFactory} object is used by the library, and you can @@ -540,12 +539,11 @@ variable @cindex @code{SOURCE_HIGHLIGHT_DATADIR} @code{SOURCE_HIGHLIGHT_DATADIR} (see also the program @sourcehighlightsettings{} which can store settings in a configuration -file of the user's home, @inforef{The program -source-highlight-settings,,source-highlight}). +file of the user's home, @xref{The program source-highlight-settings,,,source-highlight}). When running the program @sourcehighlight{} this value can be overridden with the command line option @code{--data-dir} -(@inforef{Configuration files,,source-highlight}). +(@xref{Configuration files,,,source-highlight}). When using the @value{srchilitelib} from a program, one might need to change the value for data dir, dynamically, and in a consistent way, @@ -611,7 +609,7 @@ send electronic mail to @code{bug-source-highlight at gnu dot org}. Include the version number, which you can find by running @w{@samp{source-highlight --version}}. Also include in your message the output that the program -produced and the output you expected.@refill +produced and the output you expected. If you have other questions, comments or suggestions about @command{source-highlight}, contact the author via electronic mail diff --git a/doc/source-highlight.texi b/doc/source-highlight.texi index 23aa065..cc4ae5c 100644 --- a/doc/source-highlight.texi +++ b/doc/source-highlight.texi @@ -114,7 +114,7 @@ field names, etc.) by relying on the program @emph{ctags}, Since version 3.0, GNU Source-highlight also provides a C++ library (which is used by the main program itself), that can be used by C++ programmers to add highlighting functionalities to their -programs. @inforef{Introduction,,source-highlight-info}. +programs. @xref{Introduction,,source-highlight-info}. @menu * Supported languages:: @@ -4540,7 +4540,7 @@ mail to Include the version number, which you can find by running @w{@samp{source-highlight --version}}. Also include in your message the output that the program -produced and the output you expected.@refill +produced and the output you expected. Even better, please file a bug report at Savannah site: |