texinfo ChangeLog NEWS doc/texinfo.txi util/htm...

[Karl Berry]

CVSROOT:        /sources/texinfo
Module name:    texinfo
Changes by:     Karl Berry <karl>       10/08/02 00:43:56

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

Log message:
        (loading init files): edit

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texinfo/ChangeLog?cvsroot=texinfo&r1=1.1086&r2=1.1087
http://cvs.savannah.gnu.org/viewcvs/texinfo/NEWS?cvsroot=texinfo&r1=1.196&r2=1.197
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/texinfo.txi?cvsroot=texinfo&r1=1.276&r2=1.277
http://cvs.savannah.gnu.org/viewcvs/texinfo/util/htmlxref.cnf?cvsroot=texinfo&r1=1.5&r2=1.6

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/texinfo/texinfo/ChangeLog,v
retrieving revision 1.1086
retrieving revision 1.1087
diff -u -b -r1.1086 -r1.1087
--- ChangeLog   1 Aug 2010 22:06:47 -0000       1.1086
+++ ChangeLog   2 Aug 2010 00:43:55 -0000       1.1087
@@ -1,3 +1,7 @@
+2010-08-01  Karl Berry  <address@hidden>
+
+       * doc/texinfo.txi (Loading Initialization Files): capitalize+edit.
+
 2010-08-01  Patrice Dumas  <address@hidden>
 
        * texi2html/texi2html.pl (set_variable),

Index: NEWS
===================================================================
RCS file: /sources/texinfo/texinfo/NEWS,v
retrieving revision 1.196
retrieving revision 1.197
diff -u -b -r1.196 -r1.197
--- NEWS        25 Jul 2010 00:24:52 -0000      1.196
+++ NEWS        2 Aug 2010 00:43:56 -0000       1.197
@@ -1,4 +1,4 @@
-$Id: NEWS,v 1.196 2010/07/25 00:24:52 karl Exp $
+$Id: NEWS,v 1.197 2010/08/02 00:43:56 karl Exp $
 This NEWS file records noteworthy changes, very tersely.
 See the manual for detailed information.
 
@@ -25,16 +25,17 @@
 
 * Language:
   . new command @part for a group of chapters.
-  . new environments @smallquotation and @raggedright.
+  . new environments @raggedright and @smallquotation.
   . new command @headitemfont for the sake of template rows.
   . new diacritic command @ogonek.
   . new commands for Icelandic letters eth and thorn: @DH{} @dh{} @TH{} @th{}.
   . DEL (0x7f = 0177 = 127) is a true comment character (catcode 14 in TeX).
 
 * texi2html:
-  . new program, replacing and upward-compatible with makeinfo,
-    with many additional features.  Cross-manual references are now
-    fully supported, for one.  See texi2html/NEWS for its own changes.    
+  . new program, replacing and upward-compatible with makeinfo, much
+    slower, but with many additional features.  Cross-manual references
+    are now fully supported, for one.  See xxx in the manual for more
+    about this reimplementation.
 
 * texinfo.tex:
   . support some per-language hyphenation, when the underlying TeX

Index: doc/texinfo.txi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.276
retrieving revision 1.277
diff -u -b -r1.276 -r1.277
--- doc/texinfo.txi     31 Jul 2010 14:25:20 -0000      1.276
+++ doc/texinfo.txi     2 Aug 2010 00:43:56 -0000       1.277
@@ -1,5 +1,5 @@
 \input texinfo.tex    @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.276 2010/07/31 14:25:20 karl Exp $
address@hidden $Id: texinfo.txi,v 1.277 2010/08/02 00:43:56 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.
 
@@ -654,7 +654,7 @@
 
 texi2any Output Customization
 
-* Loading initialization files::      Initialization files search paths.
+* Loading Initialization Files::   Initialization files and their search paths.
 * Initialization files basics::       General informations on initialization 
                                       files.
 * Elements::                          The main division of output document.
@@ -16046,7 +16046,7 @@
 below).  @var{path} can be a single directory, or a list of several
 directories separated by the usual path separator character (@samp{:}
 on GNU and Unix systems, @samp{;} on MS-DOS/MS-Windows).
address@hidden initialization files}.
address@hidden Initialization Files}.
 
 @item address@hidden
 @opindex --css-include
@@ -16192,8 +16192,8 @@
 for these customization files, but that is not enforced by anything;
 the @var{file} name is taken literally.  @option{--conf-dir} (see
 above) may be used to add to the list of directories in which these
-customization files are searched for.  @xref{Loading initialization
-files}.
+customization files are searched for.  @xref{Loading Initialization
+Files}.
 
 @item address@hidden
 @opindex address@hidden
@@ -17737,10 +17737,9 @@
 @option{--html} option, it will generate HTML, for web browsers and
 other programs.  This chapter gives some details on such HTML output.
 
-
address@hidden can also write in XML and Docbook format, but we do
-not as yet describe these further.  @xref{Output Formats}, for a brief
-overview of all the output formats.
address@hidden can also produce output in XML and Docbook formats,
+but we do not as yet describe these in detail.  @xref{Output Formats},
+for a brief overview of all the output formats.
 
 @menu
 * HTML Translation::       Details of the HTML output.
@@ -17761,10 +17760,6 @@
 @samp{>} and @samp{&} characters which have special significance in
 HTML).  @xref{Conditional Commands}.
 
address@hidden address@hidden, ignored in HTML output}
-The @option{--footnote-style} option is currently ignored for HTML output;
-footnotes are always linked to the end of the output file.
-
 @cindex Navigation bar, in HTML output
 By default, a navigation bar is inserted at the start of each node,
 analogous to Info output.  If the @samp{--no-headers} option is used,
@@ -17773,6 +17768,12 @@
 navigation with browsers like Lynx and @w{Emacs W3} which implement
 this address@hidden feature.
 
address@hidden Footnote styles, in HTML
+In HTML, when the footnote style is @samp{end}, or if the output is
+not split, footnotes are put at the end of the output.  If set to
address@hidden, and the output is split, they are placed in a
+separate file.  @xref{Footnote Styles}.
+
 @cindex HTML output, browser compatibility of
 The HTML generated is standard address@hidden  It also tries to be as
 compatible as possible with earlier standards (e.g., address@hidden,
@@ -17783,8 +17784,8 @@
 @samp{<html>} attribute is used; 3)@tie{} Entities that are not in the
 address@hidden standard are also used.
 
-It is possible to output strict address@hidden output by using
address@hidden (@pxref{Invoking texi2any}).
+Using @samp{--init-file=html32.init} produces strict address@hidden
+output (@pxref{Invoking texi2any}).
 
 Please report output from an error-free run of @code{makeinfo} which
 has browser portability problems as a bug (@pxref{Reporting Bugs}).
@@ -18438,8 +18439,8 @@
 monolithic output (@option{--no-split}), the @code{mono} url will be
 used, when generating output that is split by node, the @code{node}
 url will be used, etc.  However, if a manual is not available in that
-form, whatever is available will be used.  Here is the search order
-for each style that can be generated:
+form, anything that is available can be used.  Here is the search
+order for each style:
 
 @smallexample
 node    @result{} node,    section, chapter, mono
@@ -18450,8 +18451,8 @@
 
 @opindex address@hidden, and HTML cross-references}
 These section- and chapter-level cross-manual references can succeed
-only when the target manual was created using @option{--node-files},
-which is the default for split output.
+only when the target manual was created using @option{--node-files};
+this is the default for split output.
 
 If you have additions or corrections to the @file{htmlxref.cnf}
 distributed with Texinfo, please email @email{bug-texinfo@@gnu.org}.
@@ -18512,7 +18513,7 @@
 @cartouche
 @quotation Warning
 All of this information, with the exception of that about command-line
-options and search directories (@pxref{Loading initialization files})
+options and search directories (@pxref{Loading Initialization Files})
 may become obsolete in a future Texinfo release.  Right now, the
 ``API'' described in this chapter is immature, badly designed and
 incomplete, so we must keep open the possibility of incompatible,
@@ -18522,7 +18523,7 @@
 @end cartouche
 
 @menu
-* Loading initialization files::      Initialization files search paths.
+* Loading Initialization Files::   Initialization files and their search paths.
 * Initialization files basics::       General informations on initialization 
                                       files.
 * Elements::                          The main division of output document.
@@ -18544,7 +18545,7 @@
 * Customizing CSS::
 @end menu
 
address@hidden Loading initialization files
address@hidden Loading Initialization Files
 @section Loading initialization files and search paths
 
 It is possible to load initialization files to modify almost every
@@ -18569,49 +18570,46 @@
 (likewise specified at compile time, e.g., @file{/usr/local/share})
 @end table
 
-All the files found are used, in that order. 
+All @file{Config} files found are used, in the above order. 
 
-The most common way to load initialization files is to use the 
address@hidden option to specify the file to be loaded.  The 
-initialization files are looked for
-in for in the same directories than @file{Config} files, and also
-in additional directories (the same that are used 
-for @ref{HTML Xref Configuration} in the @file{init/} subdirectory).  
-By default the following directories are searched, in this
-order (where @var{prog} is the name of the program invoked on the
-command line) the first file found is used:
+The most common way to load an initialization file is with the
address@hidden option, explicitly specifying the file to be
+loaded.  By default the following directories are searched, in the
+following order, where @var{prog} is the name of the program invoked
+on the command line (@command{makeinfo}, @command{texi2any}, etc.).
+The first file found is used:
 
 @enumerate
address@hidden The current directory @file{.};
address@hidden The current directory @file{./};
 
address@hidden @file{$HOME/address@hidden, where @env{$HOME} is the user home 
directory;
address@hidden @file{~/address@hidden/}
+(where @code{~} is the current user's home directory)
 
address@hidden @address@hidden/@var{prog}}, where @var{sysconfdir} is
-the system directory for host-specific configuration, determined at
-build time (@code{/usr/local/etc} by default);
address@hidden @address@hidden/@var{prog}/}
+(where @var{sysconfdir} is the system configuration directory
+specified at compile-time, e.g., @file{/usr/local/etc})
 
address@hidden @address@hidden/@var{prog}} where @var{datadir} is the
-system directory for data files, determined at build time
-(@code{/usr/local/share} by default);
address@hidden @address@hidden/@var{prog}/}
+(likewise specified at compile time, e.g., @file{/usr/local/share})
 
address@hidden the directory @file{.texinfo/init} in the current directory;
address@hidden @file{./.texinfo/init/} under the current directory;
 
address@hidden @file{$HOME/.texinfo/init} where @env{$HOME} is the user home 
directory;
address@hidden @file{~/.texinfo/init/} under the current home directory;
 
address@hidden @address@hidden/texinfo/init} with @var{sysconfdir} as above;
address@hidden @address@hidden/texinfo/init/} with @var{sysconfdir} as above;
 
address@hidden @address@hidden/texinfo/init} with @var{datadir} as above.
address@hidden @address@hidden/texinfo/init/} with @var{datadir} as above.
 
 @end enumerate
 
-Additional directories may be appended with @option{--conf-dir}.
+Additional directories may be prepended to the list with the
address@hidden option.
 
 
 @node Initialization files basics
 @section General informations on initialization files
 
-Initialization files are @command{perl} files, read as explained
-in @ref{Loading initialization files}. 
+Initialization files are Perl source.
 A good source of inspiration could be the initialization files provided
 in the Texinfo distribution.  They all have @samp{.init} extension.
 The @file{texi2html.init} file is used to set all the defaults, and,
@@ -24229,7 +24227,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.276 2010/07/31 14:25:20 karl Exp $
+$Id: texinfo.txi,v 1.277 2010/08/02 00:43:56 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}
@@ -24308,7 +24306,7 @@
 
 @verbatim
 \input texinfo   @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.276 2010/07/31 14:25:20 karl Exp $
address@hidden $Id: texinfo.txi,v 1.277 2010/08/02 00:43:56 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.5
retrieving revision 1.6
diff -u -b -r1.5 -r1.6
--- util/htmlxref.cnf   1 Aug 2010 00:35:03 -0000       1.5
+++ util/htmlxref.cnf   2 Aug 2010 00:43:56 -0000       1.6
@@ -1,5 +1,5 @@
 # htmlxref.cnf - reference file for Texinfo files on the web.
-htmlxrefversion=2010-07-31.23; # UTC
+htmlxrefversion=2010-08-01.16; # UTC
 
 # Copyright 2010 Free Software Foundation, Inc.
 # 
@@ -55,6 +55,9 @@
 gnubg          mono    ${RS}/gnubg/manual/gnubg.html
 gnubg          node    ${RS}/gnubg/manual/html_node/
 
+gnubik         mono    ${RS}/gnubik/manual/gnubik.html
+gnubik         node    ${RS}/gnubik/manual/html_node/
+
 gnus           mono    ${RS}/emacs/manual/html_node/mh-e/
 gnus           node    ${RS}/emacs/manual/html_mono/mh-e.html