diff options
author | Werner Lemberg <wl@gnu.org> | 2014-10-12 17:54:30 +0200 |
---|---|---|
committer | Werner Lemberg <wl@gnu.org> | 2014-10-12 17:54:30 +0200 |
commit | 25329ffce61177d82e66eeb3eb1ee92a4230a362 (patch) | |
tree | 0e3591d29a6696c510e6d296c402015f4d2d76f1 | |
parent | 75c9895ae7258a4b525e063ae8e865234a1ca3c5 (diff) | |
download | groff-git-25329ffce61177d82e66eeb3eb1ee92a4230a362.tar.gz |
* doc/groff.texinfo: Various minor fixes.
Most of those glitches have been found by comparing the info output
from makeinfo 4.13 and the current SVN development version (of
makeinfo).
-rw-r--r-- | ChangeLog | 8 | ||||
-rw-r--r-- | doc/groff.texinfo | 36 |
2 files changed, 28 insertions, 16 deletions
@@ -1,5 +1,13 @@ 2014-10-12 Werner LEMBERG <wl@gnu.org> + * doc/groff.texinfo: Various minor fixes. + + Most of those glitches have been found by comparing the info output + from makeinfo 4.13 and the current SVN development version (of + makeinfo). + +2014-10-12 Werner LEMBERG <wl@gnu.org> + * doc/groff.texinfo: Improve indexing. Change @DefXXXItem and @DefXXXListEnd macros to not insert an index diff --git a/doc/groff.texinfo b/doc/groff.texinfo index ab52a2807..df3f63cda 100644 --- a/doc/groff.texinfo +++ b/doc/groff.texinfo @@ -32,9 +32,9 @@ Copyright @copyright{} 1994-2014 Free Software Foundation, Inc. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no -Invariant Sections, with the Front-Cover texts being `A GNU Manual,'' +Invariant Sections, with the Front-Cover texts being ``A GNU Manual,'' and with the Back-Cover Texts as in (a) below. A copy of the license is -included in the section entitled `GNU Free Documentation License.'' +included in the section entitled ``GNU Free Documentation License.'' (a) The FSF's Back-Cover Text is: ``You have the freedom to copy and modify this GNU manual. Buying copies from the FSF supports it in @@ -740,7 +740,7 @@ according to a bibliographic database. Unfortunately, Ossanna's @code{troff} was written in @w{PDP-11} assembly language and produced output specifically for the CAT phototypesetter. He rewrote it in C, although it was now 7000@tie{}lines of uncommented -code and still dependent on the CAT. As the CAT became less common, and +code and still dependent on the CAT@. As the CAT became less common, and was no longer supported by the manufacturer, the need to make it support other devices became a priority. However, before this could be done, Ossanna died by a severe heart attack in a hospital while recovering @@ -1984,6 +1984,7 @@ one This is the first paragraph. Notice how the first line of the resulting paragraph lines up with the other lines in the paragraph. @endExample + @Example longlabel This paragraph had a long label. The first @@ -3461,6 +3462,7 @@ You may control the style used to print section numbers, within numbered section headings, by defining an appropriate alias for the string @code{SN-STYLE}. The default style, in which the printed section number is followed by a terminating period, is obtained by defining the alias + @Example .als SN-STYLE SN-DOT @endExample @@ -3468,6 +3470,7 @@ is followed by a terminating period, is obtained by defining the alias @noindent If you prefer to omit the terminating period, from section numbers appearing in numbered section headings, you may define the alias + @Example .als SN-STYLE SN-NO-DOT @endExample @@ -4294,11 +4297,11 @@ following definitions. The following accent marks are available after invoking the @code{AM} macro: -@Defstr {\', ms} +@Defstr {', ms} Acute accent. @endDefstr -@Defstr {\`, ms} +@Defstr {`, ms} Grave accent. @endDefstr @@ -5027,7 +5030,7 @@ character which immediately follows the number or expression. Each of these units are understood, by @code{gtroff}, to be a multiple of its @dfn{basic unit}. So, whenever a different measurement unit is specified @code{gtroff} converts this into its @dfn{basic units}. This -basic unit, represented by a @samp{u}, is a device dependent measurement +basic unit, represented by a @samp{u}, is a device dependent measurement, which is quite small, ranging from 1/75@dmn{th} to 1/72000@dmn{th} of an inch. The values may be given as fractional numbers; however, fractional basic units are always rounded to integers. @@ -6157,7 +6160,7 @@ the check for the overfull line hasn't been done yet at the point where register which is even greater than the current line length. In the second input line, the insertion of @code{\h'0'} to emit an -invisible zero-width space forces @code{troff} to check the line length +invisible zero-width space forces @code{troff} to check the line length, which in turn causes the start of a new output line. Now @code{.k} returns the expected value. @endDefreq @@ -7744,7 +7747,7 @@ mode, and 0 in normal mode. Sometimes it may may be desirable to use the @code{tc} request to fill a particular tab stop with a given glyph (for example dots in a table of contents), but also normal tab stops on the rest of the line. For this -@code{gtroff} provides an alternate tab mechanism, called @dfn{leaders} +@code{gtroff} provides an alternate tab mechanism, called @dfn{leaders}, which does just that. @cindex leader character @@ -11670,7 +11673,7 @@ Handle the parameters of a macro as if they were an argument to the @result{} $^=`" This is a "test"' @endExample -This escape is useful mainly for macro packages like @file{trace.tmac} +This escape is useful mainly for macro packages like @file{trace.tmac}, which redefines some requests and macros for debugging purposes. @endDefesc @@ -12138,8 +12141,8 @@ available drawing functions. The default scaling indicator for all subcommands of @code{\D} is @samp{m} for horizontal distances and @samp{v} for vertical ones. -Exceptions are @w{@code{\D'f @dots{}'}} and @w{@code{\D't @dots{}'}} -which use @code{u} as the default, and @w{@code{\D'F@var{x} @dots{}'}} +Exceptions are @w{@code{\D'f @dots{}'}} and @w{@code{\D't @dots{}'}}, +which use @code{u} as the default, and @w{@code{\D'F@var{x} @dots{}'}}, which arguments are treated similar to the @code{defcolor} request. @table @code @@ -12322,9 +12325,9 @@ command @code{\D'Fd'} doesn't take an argument. Examples: @Example -@endExample \D'Fg .3' \" same gray as \D'f 700' \D'Fr #0000ff' \" blue +@endExample @end table @endDefesc @@ -13753,8 +13756,8 @@ print out the @code{nr} requests which set the number registers the @code{so} request. For most practical purposes, the number registers @code{seconds}, -@code{minutes}, and @code{hours} which are initialized at start-up of -@code{gtroff} should be sufficient. Use the @code{af} request to get a +@code{minutes}, and @code{hours}, which are initialized at start-up of +@code{gtroff}, should be sufficient. Use the @code{af} request to get a formatted output: @Example @@ -14181,7 +14184,7 @@ empty); diversions and strings can contain elements in both lists. Note that the @code{chop} request simply reduces the number of elements in a macro, string, or diversion by one. Exceptions are -@dfn{compatibility save} and @dfn{compatibility ignore} input tokens +@dfn{compatibility save} and @dfn{compatibility ignore} input tokens, which are ignored. The @code{substring} request also ignores those input tokens. @@ -16780,6 +16783,7 @@ point size is @var{n}@tie{}scaled points. @kindex unscaled_charwidths Make the font handling module always return unscaled character widths. Needed for the @code{grohtml} device. + @item use_charnames_in_special @kindex use_charnames_in_special This command indicates that @code{gtroff} should encode special @@ -16903,7 +16907,7 @@ the only exception is @samp{\-} which is identical to @code{\[-]}. have difficulties with eight-bit characters. For this reason, there is a convention that the entity name @samp{char@var{n}} is equivalent to the single input character whose code is@tie{}@var{n}. For example, -@samp{char163} would be equivalent to the character with code@tie{}163 +@samp{char163} would be equivalent to the character with code@tie{}163, which is the pounds sterling sign in the ISO@tie{}@w{Latin-1} character set. You shouldn't use @samp{char@var{n}} entities in font description files since they are related to input, not output. Otherwise, you get |