texinfo update (Fri Aug 27 18:22:01 EDT 2004)

[Karl Berry]

Index: ChangeLog
===================================================================
RCS file: /cvsroot/texinfo/texinfo/ChangeLog,v
retrieving revision 1.384
retrieving revision 1.385
diff -c -r1.384 -r1.385
*** ChangeLog   27 Aug 2004 13:58:03 -0000      1.384
--- ChangeLog   27 Aug 2004 22:22:09 -0000      1.385
***************
*** 1,5 ****
--- 1,8 ----
  2004-08-27  Karl Berry  <address@hidden>
  
+       * doc/texinfo.txi (Macro details): more warnings about macro usage.
+       Report from: Stepan Kasal <address@hidden>, 24 Aug 2004 09:29:35 +0200.
+ 
        * doc/texinfo.tex (\Efloat): \vskip\parskip after printing the
        caption; previous \printedsomething code to do this had become
        obsolete.  Reported by Stepan.
Index: doc/texinfo.txi
===================================================================
RCS file: /cvsroot/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.109
retrieving revision 1.110
diff -c -r1.109 -r1.110
*** doc/texinfo.txi     27 Aug 2004 13:53:40 -0000      1.109
--- doc/texinfo.txi     27 Aug 2004 22:22:09 -0000      1.110
***************
*** 1,5 ****
  \input texinfo.tex    @c -*-texinfo-*-
! @c $Id: texinfo.txi,v 1.109 2004/08/27 13:53:40 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.110 2004/08/27 22:22:09 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.
  
***************
*** 13594,13602 ****
  
  
  @node Macro Details
! @section Macro Details
  @cindex Macro details
  @cindex Details of macro usage
  
  Due to unavoidable limitations, certain macro-related constructs cause
  problems with @TeX{}.  If you get macro-related errors when producing
--- 13594,13603 ----
  
  
  @node Macro Details
! @section Macro Details and Caveats
  @cindex Macro details
  @cindex Details of macro usage
+ @cindex Caveats for macro usage
  
  Due to unavoidable limitations, certain macro-related constructs cause
  problems with @TeX{}.  If you get macro-related errors when producing
***************
*** 13633,13638 ****
--- 13634,13657 ----
  Macro arguments cannot cross lines.
  
  @item
+ In general, you can't arbitrarily substitute a macro call for Texinfo
+ command arguments, even when the text is the same.  It might work with
+ some commands, it fails with others.  Best not to do it at all.  For
+ instance, this fails:
+ 
+ @example
+ @@macro offmacro
+ off
+ @@end macro
+ @@headings @@offmacro
+ @end example
+ 
+ @noindent
+ You would expect this to be equivalent to @code{@@headings off}, but
+ for @TeX{}nical reasons, it fails with a mysterious error message
+ (@code{Paragraph ended before @@headings was complete}).
+ 
+ @item
  Macros cannot define macros in the natural way.  To do this, you must
  use conditionals and raw @TeX{}.  For example:
  
***************
*** 18324,18330 ****
  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.109 2004/08/27 13:53:40 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}
--- 18343,18349 ----
  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.110 2004/08/27 22:22:09 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}
***************
*** 18390,18396 ****
  
  @verbatim
  \input texinfo   @c -*-texinfo-*-
! @comment $Id: texinfo.txi,v 1.109 2004/08/27 13:53:40 karl Exp $
  @comment %**start of header
  @setfilename sample.info
  @include version.texi
--- 18409,18415 ----
  
  @verbatim
  \input texinfo   @c -*-texinfo-*-
! @comment $Id: texinfo.txi,v 1.110 2004/08/27 22:22:09 karl Exp $
  @comment %**start of header
  @setfilename sample.info
  @include version.texi
P ChangeLog
P doc/texinfo.txi