summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorWerner Lemberg <wl@gnu.org>2014-10-12 17:54:30 +0200
committerWerner Lemberg <wl@gnu.org>2014-10-12 17:54:30 +0200
commit25329ffce61177d82e66eeb3eb1ee92a4230a362 (patch)
tree0e3591d29a6696c510e6d296c402015f4d2d76f1
parent75c9895ae7258a4b525e063ae8e865234a1ca3c5 (diff)
downloadgroff-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--ChangeLog8
-rw-r--r--doc/groff.texinfo36
2 files changed, 28 insertions, 16 deletions
diff --git a/ChangeLog b/ChangeLog
index bd89b1da9..3cccca74c 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -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