texinfo/doc texinfo.txi

[Karl Berry]

CVSROOT:        /sources/texinfo
Module name:    texinfo
Changes by:     Karl Berry <karl>       12/04/21 23:19:47

Modified files:
        doc            : texinfo.txi 

Log message:
        tweak BASEFILENAME_LENGTH text, rm old/gone behavior of -E

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/texinfo.txi?cvsroot=texinfo&r1=1.436&r2=1.437

Patches:
Index: texinfo.txi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.436
retrieving revision 1.437
diff -u -b -r1.436 -r1.437
--- texinfo.txi 21 Apr 2012 17:44:46 -0000      1.436
+++ texinfo.txi 21 Apr 2012 23:19:47 -0000      1.437
@@ -1,5 +1,5 @@
 \input texinfo.tex    @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.436 2012/04/21 17:44:46 pertusus Exp $
address@hidden $Id: texinfo.txi,v 1.437 2012/04/21 23:19:47 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.
 
@@ -16840,12 +16840,6 @@
 @var{file}.  Normally, the result of macro expansion is used
 internally by @code{makeinfo} and then discarded.
 
-When the output format being produced requires calling
address@hidden, this option implies passing @code{-E}, with no
-argument (@pxref{Format with texi2dvi,, Format with @code{texi2dvi}}).
-If you don't need the macro-expanded output file, you can use
address@hidden -E} (see @code{--Xopt} below).
-
 @item --no-headers
 @opindex --no-headers
 @cindex Node separators, omitting with @option{--no-headers}
@@ -17343,7 +17337,9 @@
 default string is used.
 
 @item BASEFILENAME_LENGTH
-For address@hidden  The maximum length of the base filenames.
+For address@hidden  The maximum length of the base filenames.  Default 245.
+Changing this would make cross-manual references to such long node
+names invalid (@pxref{HTML Xref Link Basics}).
 
 @item BEFORE_OVERVIEW
 @itemx BEFORE_TOC_LINES
@@ -19093,10 +19089,14 @@
 kludge (due to XHTML rules) is not necessary for filenames, and is
 therefore omitted.
 
address@hidden BASEFILENAME_LENGTH
 Another rule, that only holds for filenames, is that base filenames 
 are truncated to 245 characters, to allow for an extension to be 
-prepended and still comply with a 255 characters limit which is 
-common to most filesystems.
+appended and still comply with the 255-character limit which is common
+to many filesystems.  Although technically this can be changed with
+the @code{BASEFILENAME_LENGTH} configuration variable (@pxref{Other
+Configuration Variables}), doing so would make cross-manual references
+to such nodes invalid.
 
 Any directory part in the filename argument of the source cross
 reference command is ignored.  Thus, 
@code{@@address@hidden,,,../address@hidden and
@@ -21945,7 +21945,7 @@
 Revision Control System}) or other version control systems, which
 expand it into a string such as:
 @example
-$Id: texinfo.txi,v 1.436 2012/04/21 17:44:46 pertusus Exp $
+$Id: texinfo.txi,v 1.437 2012/04/21 23:19:47 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}