texinfo/doc texinfo.txi,1.38,1.39

[karl]

Update of /cvsroot/texinfo/texinfo/doc
In directory sheep:/tmp/cvs-serv12339

Modified Files:
        texinfo.txi 
Log Message:
(HTML Xref *): new nodes.


Index: texinfo.txi
===================================================================
RCS file: /cvsroot/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.38
retrieving revision 1.39
diff -C2 -d -r1.38 -r1.39
*** texinfo.txi 15 Mar 2004 16:22:32 -0000      1.38
--- texinfo.txi 18 Mar 2004 22:03:18 -0000      1.39
***************
*** 607,610 ****
--- 607,618 ----
  * HTML Xref::              Cross-references in HTML output.
  
+ HTML Cross-references
+ 
+ * Link Basics:       HTML Xref Link Basics:
+ * Node Expansion:    HTML Xref Node Name Expansion:
+ * Command Expansion: HTML Xref Command Expansion:
+ * 8-bit Expansion:   HTML Xref 8-bit Character Expansion:
+ * Mismatch:          HTML Xref Mismatch:
+ 
  @@-Command List
  
***************
*** 618,621 ****
--- 626,633 ----
  * All-permissive Copying License::
  
+ Copying This Manual
+ 
+ * GNU Free Documentation License::  License for copying this manual.
+ 
  Include Files
  
***************
*** 16061,16075 ****
  that can be used.
  
! (Cross-references in Texinfo can actually refer either to nodes or
  anchors (@pxref{anchor}), but anchors are treated identically to nodes
  in this context, so we'll continue to say ``node'' names for
! simplicity.)
  
! @@-commands and 8-bit characters are not presently handled by
! @command{makeinfo} for HTML cross-references.  See the next section.
  
  A special exception: the Top node (@pxref{The Top Node}) is always
  mapped to the file @file{index.html}, to match web server software.
! However, the HTML target remains @samp{Top}.
  
  @enumerate
--- 16073,16091 ----
  that can be used.
  
! Cross-references in Texinfo can actually refer either to nodes or
  anchors (@pxref{anchor}), but anchors are treated identically to nodes
  in this context, so we'll continue to say ``node'' names for
! simplicity.
  
! (@@-commands and 8-bit characters are not presently handled by
! @command{makeinfo} for HTML cross-references.  See the next section.)
  
  A special exception: the Top node (@pxref{The Top Node}) is always
  mapped to the file @file{index.html}, to match web server software.
! However, the HTML @emph{target} is @samp{Top}.  Thus (in the split case):
! @example
! @@address@hidden, Introduction,, emacs, The GNU Emacs address@hidden
! @result{} <a href="emacs/index.html#Top">
! @end example
  
  @enumerate
***************
*** 16114,16119 ****
  
  On case-folding computer systems, nodes differing only by case will be
! mapped to the same file.  Many other distinct node names will be
! mapped to the same file name, on any system.
  
  In particular, as mentioned above, Top always maps to the file
--- 16130,16134 ----
  
  On case-folding computer systems, nodes differing only by case will be
! mapped to the same file.  
  
  In particular, as mentioned above, Top always maps to the file
***************
*** 16146,16150 ****
  Then, for the following commands, the command name and braces are removed,
  the text of the argument is recursively transformed: @code{
- @@acronym
  @@asis
  @@b
--- 16161,16164 ----
***************
*** 16179,16212 ****
  
  @multitable @columnfractions .3 .5
  @item @code{@@(space)}          @tab (space)
  @item @code{@@(tab)}            @tab (space)
- @item @code{@@(newline)}        @tab (space)
- @item @code{@@*}                @tab (space)
  @item @code{@@!}                @tab @samp{!}
! @item @code{@@?}                @tab @samp{?}
  @item @code{@@.}                @tab @samp{.}
  @item @code{@@:}                @tab (nothing)
! @item @code{@@tie}              @tab (space)
! @item @code{@@equiv}            @tab U+2261
! @item @code{@@print}            @tab @samp{-|}
! @item @code{@@error}            @tab @samp{error-->}
! @item @code{@@enddots}          @tab @samp{...}
! @item @code{@@TeX}              @tab @samp{TeX}
! @item @code{@@exclamdown}       @tab U+00A1
! @item @code{@@questiondown}     @tab U+00BF
! @item @code{@@pounds}           @tab U+00A3
  @item @code{@@@@}               @tab @samp{@@}
  @item @code{@@@{}               @tab @address@hidden
  @item @code{@@@}}               @tab @address@hidden
! @item @code{@@-}                @tab (nothing)
! @item @code{@@point}            @tab U+2217
! @item @code{@@result}           @tab U+21D2
! @item @code{@@expansion}        @tab U+2192
  @item @code{@@bullet}           @tab U+2022
! @item @code{@@minus}            @tab U+2212
  @item @code{@@copyright}        @tab U+00A9
  @item @code{@@dots}             @tab U+2026
  @end multitable
  
  An @code{@@email} command is replaced by the @var{text} argument if
  present, else the address.  @xref{email}.
--- 16193,16235 ----
  
  @multitable @columnfractions .3 .5
+ @item @code{@@(newline)}        @tab (space)
  @item @code{@@(space)}          @tab (space)
  @item @code{@@(tab)}            @tab (space)
  @item @code{@@!}                @tab @samp{!}
! @item @code{@@*}                @tab (space)
! @item @code{@@-}                @tab (nothing)
  @item @code{@@.}                @tab @samp{.}
  @item @code{@@:}                @tab (nothing)
! @item @code{@@?}                @tab @samp{?}
  @item @code{@@@@}               @tab @samp{@@}
  @item @code{@@@{}               @tab @address@hidden
  @item @code{@@@}}               @tab @address@hidden
! @item @code{@@LaTeX}            @tab @samp{LaTeX}
! @item @code{@@TeX}              @tab @samp{TeX}
  @item @code{@@bullet}           @tab U+2022
! @item @code{@@comman}           @tab @samp{,}
  @item @code{@@copyright}        @tab U+00A9
  @item @code{@@dots}             @tab U+2026
+ @item @code{@@enddots}          @tab @samp{...}
+ @item @code{@@equiv}            @tab U+2261
+ @item @code{@@error}            @tab @samp{error-->}
+ @item @code{@@exclamdown}       @tab U+00A1
+ @item @code{@@expansion}        @tab U+2192
+ @item @code{@@minus}            @tab U+2212
+ @item @code{@@ordf}             @tab U+00AA
+ @item @code{@@ordm}             @tab U+00BA
+ @item @code{@@point}            @tab U+2217
+ @item @code{@@pounds}           @tab U+00A3
+ @item @code{@@print}            @tab @samp{-|}
+ @item @code{@@questiondown}     @tab U+00BF
+ @item @code{@@registeredsymbol} @tab U+00AE
+ @item @code{@@result}           @tab U+21D2
+ @item @code{@@tie}              @tab (space)
  @end multitable
  
+ An @code{@@acronym} command is replaced by the first argument,
+ followed by the second argument in parentheses, if present.
+ @xref{acronym}.
+ 
  An @code{@@email} command is replaced by the @var{text} argument if
  present, else the address.  @xref{email}.
***************
*** 16329,16335 ****
  cannot begin comments as there are # in urls.
  
- The packagers could put a file with a sensible value when packaging software.
- This value could be a link to the local host if the html manual is installed
- on the local host, or a link to a host on internet if the manual is there. 
  @end ignore
  
--- 16352,16355 ----