[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 02/03: * doc/groff.texinfo: Various minor fixes.
From: |
Werner LEMBERG |
Subject: |
[groff] 02/03: * doc/groff.texinfo: Various minor fixes. |
Date: |
Sun, 12 Oct 2014 15:56:46 +0000 |
wl pushed a commit to branch master
in repository groff.
commit 25329ffce61177d82e66eeb3eb1ee92a4230a362
Author: Werner Lemberg <address@hidden>
Date: Sun Oct 12 17:54:30 2014 +0200
* 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).
---
ChangeLog | 8 ++++++++
doc/groff.texinfo | 36 ++++++++++++++++++++----------------
2 files changed, 28 insertions(+), 16 deletions(-)
diff --git a/ChangeLog b/ChangeLog
index bd89b1d..3cccca7 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,13 @@
2014-10-12 Werner LEMBERG <address@hidden>
+ * 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 <address@hidden>
+
* 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 ab52a28..df3f63c 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 address@hidden of uncommented
-code and still dependent on the CAT. As the CAT became less common, and
+code and still dependent on the address@hidden 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:
address@hidden {\', ms}
address@hidden {', ms}
Acute accent.
@endDefstr
address@hidden {\`, ms}
address@hidden {`, 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/address@hidden to 1/address@hidden 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
address@hidden provides an alternate tab mechanism, called @dfn{leaders}
address@hidden 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 @address@hidden'f @dots{}'}} and @address@hidden't @dots{}'}}
-which use @code{u} as the default, and @address@hidden'address@hidden
@dots{}'}}
+Exceptions are @address@hidden'f @dots{}'}} and @address@hidden't @dots{}'}},
+which use @code{u} as the default, and @address@hidden'address@hidden
@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
address@hidden
\D'Fg .3' \" same gray as \D'f 700'
\D'Fr #0000ff' \" blue
address@hidden
@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},
address@hidden, and @code{hours} which are initialized at start-up of
address@hidden should be sufficient. Use the @code{af} request to get a
address@hidden, and @code{hours}, which are initialized at start-up of
address@hidden, 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
address@hidden save} and @dfn{compatibility ignore} input tokens
address@hidden 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 @address@hidden 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 @address@hidden is equivalent to
the single input character whose code address@hidden@var{n}. For example,
address@hidden would be equivalent to the character with address@hidden
address@hidden would be equivalent to the character with address@hidden,
which is the pounds sterling sign in the address@hidden@w{Latin-1} character
set. You shouldn't use @address@hidden entities in font description
files since they are related to input, not output. Otherwise, you get
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 02/03: * doc/groff.texinfo: Various minor fixes.,
Werner LEMBERG <=