texinfo ChangeLog doc/texinfo.txi util/htmlxref...

[Karl Berry]

CVSROOT:        /sources/texinfo
Module name:    texinfo
Changes by:     Karl Berry <karl>       10/10/28 16:30:18

Modified files:
        .              : ChangeLog 
        doc            : texinfo.txi 
        util           : htmlxref.cnf 

Log message:
        (HTML Customization for Text Sequences): rename+edit

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texinfo/ChangeLog?cvsroot=texinfo&r1=1.1165&r2=1.1166
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/texinfo.txi?cvsroot=texinfo&r1=1.334&r2=1.335
http://cvs.savannah.gnu.org/viewcvs/texinfo/util/htmlxref.cnf?cvsroot=texinfo&r1=1.23&r2=1.24

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/texinfo/texinfo/ChangeLog,v
retrieving revision 1.1165
retrieving revision 1.1166
diff -u -b -r1.1165 -r1.1166
--- ChangeLog   27 Oct 2010 17:28:00 -0000      1.1165
+++ ChangeLog   28 Oct 2010 16:30:16 -0000      1.1166
@@ -1,3 +1,7 @@
+2010-10-28  Karl Berry  <address@hidden>
+
+       * doc/texinfo.txi (HTML Customization for Text Sequences): rename+edit.
+
 2010-10-27  Karl Berry  <address@hidden>
 
        * doc/texinfo.txi (HTML Customization for @code{sp},

Index: doc/texinfo.txi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.334
retrieving revision 1.335
diff -u -b -r1.334 -r1.335
--- doc/texinfo.txi     27 Oct 2010 17:28:00 -0000      1.334
+++ doc/texinfo.txi     28 Oct 2010 16:30:17 -0000      1.335
@@ -1,5 +1,5 @@
 \input texinfo.tex    @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.334 2010/10/27 17:28:00 karl Exp $
address@hidden $Id: texinfo.txi,v 1.335 2010/10/28 16:30:17 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.
 
@@ -20862,7 +20862,7 @@
 * Images: HTML Customization for Images.
 * sp: HTML Customization for @code{sp}.
 * Abbrs: HTML Customization for Abbreviations. @code{@@acronym}, @code{@@abbr}.
-* Formatting characters and text::
+* Text: HTML Customization for Text Sequences. @code{-- --- `` ''}.
 * Formatting of simple line commands::
 @end menu
 
@@ -21395,59 +21395,82 @@
 @end deftypefn
 
 
address@hidden Formatting characters and text
address@hidden Processing special characters in text
address@hidden HTML Customization for Text Sequences
address@hidden HTML Customization for Text Sequences
 
-Some characters are processed especially in text: @samp{---}, @samp{--},
address@hidden and @samp{''}. This should only be done only if in normal text 
and not in 
-some commands (@code{@@code}, @code{@@address@hidden). A function reference
-is called to process the text and should take care of those constructs.
-It may also be used to transform the text, for example set it in upper
-case if it is in @code{@@sc}. This function should also take care
-of protecting special characters.
-
-
address@hidden {Function Reference} $processed_text normal_text $text 
$in_raw_text $in_preformatted $in_code $in_math $in_simple $command_stack 
-The function processes @var{$text} and returns @var{$processed_text}. 
-The other arguments give some information about the context of the text.
address@hidden is true if the text appears in special place where
-there is no formatting, typically in comments.  @var{$in_preformatted}
-is true if in a preformatted environemnt, and @var{$in_code} is true
-if in a special command like @code{@@code}, @code{@@env} where
address@hidden, @samp{--}, @samp{``} and @samp{''} should be left as is.  
address@hidden is true if in @code{@@math}.
address@hidden is true if in string context with minimal formatting.
- @var{$command_stack} is an array containing the name of the 
-formatting @@-command that enclose the text.  
address@hidden HTML customization for text sequences
address@hidden Text sequences, customizing HTML for
address@hidden Ligatures in text, customizing HTML for
+
+Some character sequences are processed especially in text: @samp{---},
address@hidden, @samp{``} and @samp{''}. This should only be done only if
+in normal text and not within commands for preformatted output
+(@code{@@code}, @code{@@address@hidden).  A function reference is called
+to process the text and take care of these constructs.  It may also be
+used to transform the text, for example, convert to upper case if it
+is in @code{@@sc}.  The function should also take care of protecting
+special characters.
+
address@hidden {Function Reference} $processed_text normal_text $text @
+     $in_raw_text $in_preformatted $in_code $in_math $in_simple $command_stack 
+Process @var{$text} and return @var{$processed_text}.  The other
+arguments give some information about the context of the text.
 
-In the default case the @samp{---}, @samp{--}, @samp{``} and @samp{''}
address@hidden @var
address@hidden $in_raw_text
+True if the text appears in a place where there is no formatting at
+all; e.g., in comments.
+
address@hidden $in_preformatted
+True if within a preformatted environemnt
+
address@hidden $in_code
+True if within a special command such as @code{@@code} or @code{@@env}
+where the text sequences should be left as is.
+
address@hidden $in_math
+True if within @code{@@math}.
+
address@hidden $in_simple
+True if in a string context with minimal formatting.
+
address@hidden $command_stack
+Array containing the name of the formatting @@-commands that enclose
+the text.
address@hidden table
+
+By default, the @samp{---}, @samp{--}, @samp{``} and @samp{''}
 constructs are expanded if needed and the text is upper-cased if in 
address@hidden@@sc}. Special characters (@samp{&}, @samp{"},
address@hidden<} and @samp{>} in HTML) are protected if needed. 
address@hidden@@sc}.  Special characters (@samp{&}, @samp{"}, @samp{<} and
address@hidden>} in HTML) are protected if needed.
 @end deftypefn
 
-Some characters are special, for example we have  @samp{&}, @samp{"}, 
address@hidden<} and @samp{>} in HTML. In some cases some
-pieces of text don't go through the above function, but still 
-needs to be protected to appear in text.
-This is done by the function associated with the function reference
address@hidden Protecting special output characters
address@hidden Output format characters, protecting
address@hidden HTML characters, protecting
+Some characters are special in a particular output format, such as
address@hidden<} in HTML.  Some text is not processed by the above function,
+but still needs protection before output.  This is done by the
+following:
 
 @deftypefn {Function Reference} $protected_text protect_text $text
-The function processes the unprotected text @var{$text} and returns
-the resulting protected text @var{$protected_text}.
+Process the general text @var{$text} and return the resulting
+protected text @var{$protected_text}.
 @end deftypefn
 
-Empty lines are processed by the following function reference, which could
-be usefull if empty lines are to be removed for example
address@hidden Empty lines, removing
+Empty lines are processed by the following function reference, which
+can be useful if empty lines are to be removed.
 
address@hidden Definition commands, empty lines after
 @deftypefn {Function Reference} $resulting_text empty_line $empty_line $state
-This function processes an @var{$empty_line} and returns the resulting
-text @var{$resulting_text}.  @var{$state} is a structure that holds 
informations
-about the state of the parsing.
-Empty lines are left as is by default except right after a definition 
-@@-command.
+Process @var{$empty_line} and return @var{$resulting_text}.
address@hidden is a structure holding information about the state of
+parsing.  By default, empty lines are left as-is except right after a
+definition @@-command.
 @end deftypefn
 
+
 @node Formatting of simple line commands
 @subsection Customization of simple line command output
 
@@ -24834,7 +24857,7 @@
 (@url{http://www.gnu.org/software/rcs}) version control systems, which
 expand it into a string such as:
 @example
-$Id: texinfo.txi,v 1.334 2010/10/27 17:28:00 karl Exp $
+$Id: texinfo.txi,v 1.335 2010/10/28 16:30:17 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}
@@ -24913,7 +24936,7 @@
 
 @verbatim
 \input texinfo   @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.334 2010/10/27 17:28:00 karl Exp $
address@hidden $Id: texinfo.txi,v 1.335 2010/10/28 16:30:17 karl Exp $
 @comment %**start of header
 @setfilename sample.info
 @include version.texi

Index: util/htmlxref.cnf
===================================================================
RCS file: /sources/texinfo/texinfo/util/htmlxref.cnf,v
retrieving revision 1.23
retrieving revision 1.24
diff -u -b -r1.23 -r1.24
--- util/htmlxref.cnf   27 Oct 2010 17:28:01 -0000      1.23
+++ util/htmlxref.cnf   28 Oct 2010 16:30:18 -0000      1.24
@@ -1,6 +1,6 @@
 # htmlxref.cnf - reference file for Texinfo files on the web.
 
-htmlxrefversion=2010-10-27.17; # UTC
+htmlxrefversion=2010-10-28.16; # UTC
 
 # Copyright 2010 Free Software Foundation, Inc.
 # 
@@ -281,6 +281,12 @@
 
 libmatheval    mono    ${GS}/libmatheval/matheval.html
 
+libtool                mono    ${GS}/libtool/manual/libtool.html
+libtool                node    ${GS}/libtool/manual/html_node/
+
+lightning      mono    ${GS}/lightning/manual/lightning.html
+lightning      node    ${GS}/lightning/manual/html_node/
+
 liquidwar6     mono    ${GS}/liquidwar6/manual/liquidwar6.html
 liquidwar6     node    ${GS}/liquidwar6/manual/html_node/