texinfo update (Tue Dec 14 12:22:01 EST 2004)

[Karl Berry]

Index: ChangeLog
===================================================================
RCS file: /cvsroot/texinfo/texinfo/ChangeLog,v
retrieving revision 1.431
retrieving revision 1.432
diff -c -r1.431 -r1.432
*** ChangeLog   14 Dec 2004 16:58:14 -0000      1.431
--- ChangeLog   14 Dec 2004 17:21:53 -0000      1.432
***************
*** 1,5 ****
--- 1,9 ----
  2004-12-14  Karl Berry  <address@hidden>
  
+       * doc/texinfo.txi (inforef): try to explain possible uses more
+       thoroughly.
+       From: Luc Teirlinck, 13 Dec 2004 21:45:58 -0600.
+ 
        * doc/texinfo.txi (pxref): more explanation.
        * doc/info-stnd.texi (Basic Windows): put pxref in parens.
        help-texinfo mail from adl, 13 Dec 2004 17:07:50 +0100.
Index: doc/texinfo.txi
===================================================================
RCS file: /cvsroot/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.125
retrieving revision 1.126
diff -c -r1.125 -r1.126
*** doc/texinfo.txi     14 Dec 2004 16:58:15 -0000      1.125
--- doc/texinfo.txi     14 Dec 2004 17:21:53 -0000      1.126
***************
*** 1,5 ****
  \input texinfo.tex    @c -*-texinfo-*-
! @c $Id: texinfo.txi,v 1.125 2004/12/14 16:58:15 karl Exp $
  @c Ordinarily, Texinfo files have the extension .texi.  But texinfo.texi
  @c clashes with texinfo.tex on 8.3 filesystems, so we use texinfo.txi.
  
--- 1,5 ----
  \input texinfo.tex    @c -*-texinfo-*-
! @c $Id: texinfo.txi,v 1.126 2004/12/14 17:21:53 karl Exp $
  @c Ordinarily, Texinfo files have the extension .texi.  But texinfo.texi
  @c clashes with texinfo.tex on 8.3 filesystems, so we use texinfo.txi.
  
***************
*** 6416,6425 ****
  @cindex References using @code{@@inforef}
  @findex inforef
  
! @code{@@inforef} is used for cross references to Info files for which
! there are no printed manuals.  Even in a printed manual,
! @code{@@inforef} generates a reference directing the user to look in
! an Info address@hidden
  
  The command takes either two or three arguments, in the following
  order:@refill
--- 6416,6427 ----
  @cindex References using @code{@@inforef}
  @findex inforef
  
! @code{@@inforef} is used for making cross references to Info
! documents---even from a printed manual.  This might be because you
! want to refer to conditional @code{@@ifinfo} text
! (@pxref{Conditionals}), or because printed output is not available
! (perhaps because there is no Texinfo source), among other
! possibilities.
  
  The command takes either two or three arguments, in the following
  order:@refill
***************
*** 6449,6455 ****
  
  @need 800
  @noindent
! Thus,
  
  @example
  @group
--- 6451,6457 ----
  
  @need 800
  @noindent
! For example,
  
  @example
  @group
***************
*** 6460,6466 ****
  
  @need 800
  @noindent
! produces
  
  @example
  @group
--- 6462,6468 ----
  
  @need 800
  @noindent
! produces (in Info):
  
  @example
  @group
***************
*** 6471,6511 ****
  
  @need 800
  @noindent
! and
  
  @quotation
  See Info file @file{info}, node @samp{Advanced}, for more information.
  @end quotation
  
! @need 800
! @noindent
! Similarly,
! 
! @example
! @group
! @@address@hidden, , address@hidden, for more information.
! @end group
! @end example
! 
! @need 800
! @noindent
! produces
! 
! @example
! *Note (info)Advanced::, for more information.
! @end example
! 
! @need 800
! @noindent
! and
! 
! @quotation
! See Info file @file{info}, node @samp{Advanced}, for more information.
! @end quotation
  
  The converse of @code{@@inforef} is @code{@@cite}, which is used to
  refer to printed works for which no Info form exists.  @xref{cite, ,
! @code{@@address@hidden
  
  
  @node uref
--- 6473,6490 ----
  
  @need 800
  @noindent
! and (in the printed output):
  
  @quotation
  See Info file @file{info}, node @samp{Advanced}, for more information.
  @end quotation
  
! (This particular example is not realistic, since the Info manual is
! written in Texinfo, so all formats are available.)
  
  The converse of @code{@@inforef} is @code{@@cite}, which is used to
  refer to printed works for which no Info form exists.  @xref{cite, ,
! @code{@@cite}}.
  
  
  @node uref
***************
*** 18456,18462 ****
  Concurrent Versions System}) or RCS (see rcsintro(1)) version control
  systems, which expand it into a string such as:
  @example
! $Id: texinfo.txi,v 1.125 2004/12/14 16:58:15 karl Exp $
  @end example
  (This is useful in all sources that use version control, not just manuals.)
  You may wish to include the @samp{$Id:} comment in the @code{@@copying}
--- 18435,18441 ----
  Concurrent Versions System}) or RCS (see rcsintro(1)) version control
  systems, which expand it into a string such as:
  @example
! $Id: texinfo.txi,v 1.126 2004/12/14 17:21:53 karl Exp $
  @end example
  (This is useful in all sources that use version control, not just manuals.)
  You may wish to include the @samp{$Id:} comment in the @code{@@copying}
***************
*** 18522,18528 ****
  
  @verbatim
  \input texinfo   @c -*-texinfo-*-
! @comment $Id: texinfo.txi,v 1.125 2004/12/14 16:58:15 karl Exp $
  @comment %**start of header
  @setfilename sample.info
  @include version.texi
--- 18501,18507 ----
  
  @verbatim
  \input texinfo   @c -*-texinfo-*-
! @comment $Id: texinfo.txi,v 1.126 2004/12/14 17:21:53 karl Exp $
  @comment %**start of header
  @setfilename sample.info
  @include version.texi
P ChangeLog
P doc/texinfo.txi