[Groff-commit] groff ChangeLog doc/groff.texinfo

[Werner LEMBERG]

CVSROOT:        /cvsroot/groff
Module name:    groff
Changes by:     Werner LEMBERG <wl>     06/06/05 08:18:25

Modified files:
        .              : ChangeLog 
        doc            : groff.texinfo 

Log message:
        * doc/groff.texinfo: Add more index entries for copy-in mode.
        Document that a font definition file must not be called `DESC'.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/groff/ChangeLog?cvsroot=groff&r1=1.966&r2=1.967
http://cvs.savannah.gnu.org/viewcvs/groff/doc/groff.texinfo?cvsroot=groff&r1=1.239&r2=1.240

Patches:
Index: ChangeLog
===================================================================
RCS file: /cvsroot/groff/groff/ChangeLog,v
retrieving revision 1.966
retrieving revision 1.967
diff -u -b -r1.966 -r1.967
--- ChangeLog   31 May 2006 11:45:07 -0000      1.966
+++ ChangeLog   5 Jun 2006 08:18:25 -0000       1.967
@@ -1,3 +1,8 @@
+2006-06-04  Werner LEMBERG  <address@hidden>
+
+       * doc/groff.texinfo: Add more index entries for copy-in mode.
+       Document that a font definition file must not be called `DESC'.
+
 2006-05-31  Werner LEMBERG  <address@hidden>
 
        * src/roff/troff/input.cpp (token::next) <\N>: Catch negative values

Index: doc/groff.texinfo
===================================================================
RCS file: /cvsroot/groff/groff/doc/groff.texinfo,v
retrieving revision 1.239
retrieving revision 1.240
diff -u -b -r1.239 -r1.240
--- doc/groff.texinfo   28 May 2006 09:27:43 -0000      1.239
+++ doc/groff.texinfo   5 Jun 2006 08:18:25 -0000       1.240
@@ -5909,6 +5909,11 @@
 Note that the commented-out block of text does not
 cause a break.
 
address@hidden @code{ig} request, and copy-in mode
address@hidden copy-in mode, and @code{ig} request
address@hidden mode, copy-in, and @code{ig} request
address@hidden @code{ig} request, and auto-increment
address@hidden auto-increment, and @code{ig} request
 The input is read in copy-mode; auto-incremented registers @emph{are}
 affected (@pxref{Auto-increment}).
 @endDefreq
@@ -7293,6 +7298,9 @@
 @Defesc {\\t, , , }
 @cindex tab character, non-interpreted (@code{\t})
 @cindex character, tab, non-interpreted (@code{\t})
address@hidden @code{\t}, and copy-in mode
address@hidden copy-in mode, and @code{\t}
address@hidden mode, copy-in, and @code{\t}
 This escape is a non-interpreted tab character.  In copy mode
 (@pxref{Copy-in Mode}), @code{\t} is the same as a real tab character.
 @endDefesc
@@ -7525,6 +7533,9 @@
 @Defesc {\\a, , , }
 @cindex leader character, non-interpreted (@code{\a})
 @cindex character, leader, non-interpreted (@code{\a})
address@hidden @code{\a}, and copy-in mode
address@hidden copy-in mode, and @code{\a}
address@hidden mode, copy-in, and @code{\a}
 This escape is a non-interpreted leader character.  In copy mode
 (@pxref{Copy-in Mode}), @code{\a} is the same as a real leader
 character.
@@ -7715,6 +7726,9 @@
 But if @var{X} is equal to the current escape character, no warning is
 emitted.
 
address@hidden @code{\E}, and copy-in mode
address@hidden copy-in mode, and @code{\E}
address@hidden mode, copy-in, and @code{\E}
 As a consequence, only at top-level or in a diversion a backslash glyph is
 printed; in copy-in mode, it expands to a single backslash which then
 combines with the following character to an escape sequence.
@@ -8643,6 +8657,10 @@
 the current font family (as set with the @code{fam} request, @code{\F}
 escape, or with the @code{family} command in the @file{DESC} file).
 
+It is not possible to switch to a font with the name @samp{DESC}
+(whereas this name could be used as a style name; however, this is not
+recommended).
+
 @cindex previous font (@code{ft}, @code{\f[]}, @code{\fP})
 @cindex font, previous (@code{ft}, @code{\f[]}, @code{\fP})
 With no argument or using @samp{P} as an argument, @code{.ft} switches
@@ -10481,6 +10499,9 @@
 @Defreq {length, reg str}
 @cindex length of a string (@code{length})
 @cindex string, length of (@code{length})
address@hidden @code{length} request, and copy-in mode
address@hidden copy-in mode, and @code{length} request
address@hidden mode, copy-in, and @code{length} request
 Compute the number of characters of @var{str} and return it in the
 number register @var{reg}.  If @var{reg} doesn't exist, it is created.
 @code{str} is read in copy mode.
@@ -11041,7 +11062,9 @@
 
 @node Copy-in Mode, Parameters, Writing Macros, Writing Macros
 @subsection Copy-in Mode
address@hidden copy mode
 @cindex copy-in mode
address@hidden mode, copy
 @cindex mode, copy-in
 
 @cindex @code{\n}, when reading text for a macro
@@ -11098,6 +11121,7 @@
 @DefescItem {\\$, @Lparen{}, nn, }
 @DefescListEnd {\\$, @Lbrack{}, nnn, @Rbrack{}}
 @cindex copy-in mode, and macro arguments
address@hidden mode, copy-in, and macro arguments
 @cindex macro, arguments (@code{\$})
 @cindex arguments, macro (@code{\$})
 Retrieve the @address@hidden, @address@hidden or @address@hidden
@@ -12316,6 +12340,12 @@
 address@hidden
 @endExample
 
address@hidden @code{\?}, and copy-in mode
address@hidden copy-in mode, and @code{\?}
address@hidden mode, copy-in, and @code{\?}
address@hidden @code{\!}, and copy-in mode
address@hidden copy-in mode, and @code{\!}
address@hidden mode, copy-in, and @code{\!}
 @noindent
 @var{anything} may not contain newlines; use @code{\!}  to embed
 newlines in a diversion.  The escape sequence @code{\?} is also
@@ -12358,11 +12388,14 @@
 at all; its argument is simply ignored.
 @endDefesc
 
address@hidden @code{\!}, and @code{output}
address@hidden @code{\!}, and @code{output} request
 @cindex @code{output} request, and @code{\!}
address@hidden @code{output} request, and copy-in mode
address@hidden copy-in mode, and @code{output} request
address@hidden mode, copy-in, and @code{output} request
 @Defreq {output, string}
 Emit @var{string} directly to the @code{gtroff} intermediate output
-(subject to copy-mode interpretation); this is similar to @code{\!} used
+(subject to copy mode interpretation); this is similar to @code{\!} used
 at the top level.  An initial double quote in @var{string} is stripped off
 to allow initial blanks.
 
@@ -12828,11 +12861,18 @@
 @DefreqListEnd {cf, file}
 @cindex transparent output (@code{cf}, @code{trf})
 @cindex output, transparent (@code{cf}, @code{trf})
address@hidden @code{cf} request, and copy-in mode
address@hidden copy-in mode, and @code{cf} request
address@hidden mode, copy-in, and @code{cf} request
address@hidden @code{trf} request, and copy-in mode
address@hidden copy-in mode, and @code{trf} request
address@hidden mode, copy-in, and @code{trf} request
 Transparently output the contents of @var{file}.  Each line is output
-as if it were preceded by @code{\!}; however, the lines are not subject
-to copy mode interpretation.  If the file does not end with a newline,
-then a newline is added (@code{trf} only).  For example, to define a
address@hidden@code{x} containing the contents of address@hidden@file{f}, use
+as if it were preceded by @code{\!}; however, the lines are @emph{not}
+subject to copy mode interpretation.  If the file does not end with a
+newline, then a newline is added (@code{trf} only).  For example, to
+define a address@hidden@code{x} containing the contents of
address@hidden@file{f}, use
 
 @Example
 .ev 1
@@ -13047,10 +13087,14 @@
 
 @DefreqList {write, stream data}
 @DefreqListEnd {writec, stream data}
address@hidden copy-in mode, and @code{write} requests
address@hidden mode, copy-in, and @code{write} requests
address@hidden writing to file (@code{write})
address@hidden file, writing to (@code{write})
address@hidden copy-in mode, and @code{write} request
address@hidden @code{write} request, and copy-in mode
address@hidden mode, copy-in, and @code{write} request
address@hidden copy-in mode, and @code{writec} request
address@hidden @code{writec} request, and copy-in mode
address@hidden mode, copy-in, and @code{writec} request
address@hidden writing to file (@code{write}, @code{writec})
address@hidden file, writing to (@code{write}, @code{writec})
 Write to the file associated with the specified @var{stream}.
 The stream must previously have
 been the subject of an open request.  The remainder of the line is
@@ -13066,6 +13110,9 @@
 Write the contents of the macro or string @var{xx}
 to the file associated with the specified @var{stream}.
 
address@hidden @code{writem} request, and copy-in mode
address@hidden copy-in mode, and @code{writem} request
address@hidden mode, copy-in, and @code{writem} request
 @var{xx} is read in copy mode, i.e., already formatted elements are
 ignored.  Consequently, diversions must be unformatted with the
 @code{asciify} request before calling @code{writem}.  Usually, this
@@ -13097,6 +13144,9 @@
 @DefescList {\\V, , e, }
 @DefescItem {\\V, @Lparen{}, ev, }
 @DefescListEnd {\\V, @Lbrack{}, env, @Rbrack{}}
address@hidden @code{\V}, and copy-in mode
address@hidden copy-in mode, and @code{\V}
address@hidden mode, copy-in, and @code{\V}
 Interpolate the contents of the specified environment variable
 @var{env} (one-character address@hidden@var{e}, two-character name @var{ev})
 as returned by the function @code{getenv}.  @code{\V} is interpreted
@@ -13134,6 +13184,9 @@
 space characters.  All other escapes (except @code{\\} which produces a
 backslash) cause an error.
 
address@hidden @code{device} request, and copy-in mode
address@hidden copy-in mode, and @code{device} request
address@hidden mode, copy-in, and @code{device} request
 Contrary to @code{\X}, the @code{device} request simply processes its
 argument in copy mode (@pxref{Copy-in Mode}).
 
@@ -13525,6 +13578,15 @@
 Send @var{string} to the standard error output;
 this is very useful for printing debugging messages among other things.
 
address@hidden @code{tm} request, and copy-in mode
address@hidden copy-in mode, and @code{tm} request
address@hidden mode, copy-in, and @code{tm} request
address@hidden @code{tm1} request, and copy-in mode
address@hidden copy-in mode, and @code{tm1} request
address@hidden mode, copy-in, and @code{tm1} request
address@hidden @code{tmc} request, and copy-in mode
address@hidden copy-in mode, and @code{tmc} request
address@hidden mode, copy-in, and @code{tmc} request
 @var{string} is read in copy mode.
 
 The @code{tm} request ignores leading spaces of @var{string}; @code{tm1}