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

[Karl Berry]

CVSROOT:        /sources/texinfo
Module name:    texinfo
Changes by:     Karl Berry <karl>       10/10/31 18:31:33

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

Log message:
        (HTML Customization for Internal References): rename+edit

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texinfo/ChangeLog?cvsroot=texinfo&r1=1.1169&r2=1.1170
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/texinfo.txi?cvsroot=texinfo&r1=1.338&r2=1.339
http://cvs.savannah.gnu.org/viewcvs/texinfo/util/htmlxref.cnf?cvsroot=texinfo&r1=1.26&r2=1.27

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/texinfo/texinfo/ChangeLog,v
retrieving revision 1.1169
retrieving revision 1.1170
diff -u -b -r1.1169 -r1.1170
--- ChangeLog   30 Oct 2010 17:27:11 -0000      1.1169
+++ ChangeLog   31 Oct 2010 18:31:32 -0000      1.1170
@@ -1,3 +1,8 @@
+2010-10-31  Karl Berry  <address@hidden>
+
+       * doc/texinfo.txi (HTML Customization for Internal References):
+       rename+edit.
+
 2010-10-30  Karl Berry  <address@hidden>
 
        * doc/texinfo.txi (HTML Customization for External References):

Index: doc/texinfo.txi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.338
retrieving revision 1.339
diff -u -b -r1.338 -r1.339
--- doc/texinfo.txi     30 Oct 2010 17:29:07 -0000      1.338
+++ doc/texinfo.txi     31 Oct 2010 18:31:33 -0000      1.339
@@ -1,5 +1,5 @@
 \input texinfo.tex    @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.338 2010/10/30 17:29:07 karl Exp $
address@hidden $Id: texinfo.txi,v 1.339 2010/10/31 18:31:33 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.
 
@@ -5921,6 +5921,7 @@
 write @code{@@xref} at the beginning of a sentence; write
 @code{@@pxref} only within parentheses, and so address@hidden
 
+
 @node xref
 @section @code{@@xref}
 @findex xref
@@ -21506,14 +21507,58 @@
 @section Customizing HTML References
 
 @cindex References, HTML customization for 
address@hidden Cross references, HTML customization for 
 
 @menu 
+* Internal: HTML Customization for Internal References.
 * External: HTML Customization for External References.
-* Formatting a reference within a manual::
 * Footnotes formatting::
 @end menu
 
 
address@hidden HTML Customization for Internal References
address@hidden HTML Customization for Internal References
+
address@hidden HTML customization for internal references
address@hidden Internal references, HTML customization for 
+
+This function reference is used to format a reference to a node in the
+current manual (@pxref{Cross References}).
+
address@hidden {Function Reference} $text internal_ref $command $href 
$short_name @
+           $name $is_section \@@args_texi \@@formatted_args \%element
+
address@hidden @var
address@hidden $command
+The reference command, namely @code{ref}, @code{xref}, @code{pxref} or
address@hidden).
+
address@hidden $href
+An HTML href to the node.
+
address@hidden $short_name
address@hidden $name
+The text for the reference.  @var{$short_name} can be the node name
+which is assumed to be no longer than the section name.
+
address@hidden $is_section
+True if the reference is to a sectioning element. 
+
address@hidden \@@args_texi
address@hidden \@@formatted_args
+Array references containing the @@-command arguments, not formatted
+and formatted, respectively.
+
address@hidden \%element
+Hash reference with information about the target element of the
+reference.
address@hidden table
+
+The function should return the full formatted text of the internal 
+reference.
address@hidden deftypefn
+
+
 @node HTML Customization for External References
 @subsection HTML Customization for External References
 
@@ -21568,17 +21613,16 @@
 The manual file name.
 
 @item $href
-An href to the external manual constructed using the above
+An HTML href to the external manual constructed using the above
 @code{external_href} function.
 
 @item $cross_ref_name
 Optional cross reference name appearing in the reference command.
 
 @item \@@args_texi
-An array reference containing the @@-command arguments, not formatted.
-
address@hidden \@@formatted_args
-Another array reference with the formatted @@-command arguments.
address@hidden \@@formatted_args
+Array references containing the @@-command arguments, not formatted
+and formatted, respectively.
 
 @item $node
 The node name, formatted.
@@ -21589,30 +21633,6 @@
 @end deftypefn
 
 
address@hidden Formatting a reference within a manual
address@hidden Formatting a reference within a manual
-
-A function reference is available for internal references.
-
address@hidden {Function Reference} $text internal_ref $command $href 
$short_name $name $is_section \@@args_texi \@@formatted_args \%element
-This function formats a reference to a node in the current manual.
-The @var{$command} is the ref command (@code{ref}, @code{xref},
address@hidden or @code{inforef}).
address@hidden it an hypertextual reference linking to the corresponding
-node or section.  @var{$short_name} and @var{$name} hold the text for the 
-reference but @var{$short_name} can be the node name which is assumed to 
-be shorter than the section name.
address@hidden is a boolean true if the reference is a reference to a 
-sectioning element. 
address@hidden@@args_texi} is a reference on an array containing the @@-command
-arguments, not formatted, with @var{\@@formatted_args} contains the formatted
-@@-command arguments.
address@hidden is a reference on a hash holding informations about
-the element target of the reference.
-This function returns the full formatted text of the internal 
-reference.
address@hidden deftypefn
-
 @node Footnotes formatting
 @subsection Customizing the footnotes formatting
 
@@ -24907,7 +24927,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.338 2010/10/30 17:29:07 karl Exp $
+$Id: texinfo.txi,v 1.339 2010/10/31 18:31:33 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}
@@ -24986,7 +25006,7 @@
 
 @verbatim
 \input texinfo   @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.338 2010/10/30 17:29:07 karl Exp $
address@hidden $Id: texinfo.txi,v 1.339 2010/10/31 18:31:33 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.26
retrieving revision 1.27
diff -u -b -r1.26 -r1.27
--- util/htmlxref.cnf   30 Oct 2010 17:27:13 -0000      1.26
+++ util/htmlxref.cnf   31 Oct 2010 18:31:33 -0000      1.27
@@ -1,6 +1,6 @@
 # htmlxref.cnf - reference file for Texinfo files on the web.
 
-htmlxrefversion=2010-10-30.16; # UTC
+htmlxrefversion=2010-10-31.18; # UTC
 
 # Copyright 2010 Free Software Foundation, Inc.
 # 
@@ -230,6 +230,9 @@
 gperf          mono    ${GS}/gperf/manual/gperf.html
 gperf          node    ${GS}/gperf/manual/html_node/
 
+grub           mono    ${GS}/grub/manual/grub.html
+grub           node    ${GS}/grub/manual/html_node/
+
 gsasl          mono    ${GS}/gsasl/manual/gsasl.html
 gsasl          node    ${GS}/gsasl/manual/html_node/
 
@@ -265,6 +268,9 @@
 gv             mono    ${GS}/gv/manual/gv.html
 gv             node    ${GS}/gv/manual/html_node/
 
+gzip           mono    ${GS}/gzip/manual/gzip.html
+gzip           node    ${GS}/gzip/manual/html_node/
+
 hello          mono    ${GS}/hello/manual/hello.html
 hello          node    ${GS}/hello/manual/html_node/