branch master updated: * doc/texi2oldapi.texi: add information in comments on how to process in source. Fix to be processable. More prominently state that the API description is obsolete and dates from 2010/2012.

[Patrice Dumas]

This is an automated email from the git hooks/post-receive script.

pertusus pushed a commit to branch master
in repository texinfo.

The following commit(s) were added to refs/heads/master by this push:
     new 8dc1c3ed9d * doc/texi2oldapi.texi: add information in comments on how 
to process in source.  Fix to be processable.  More prominently state that the 
API description is obsolete and dates from 2010/2012.
8dc1c3ed9d is described below

commit 8dc1c3ed9d12b16b94c0672bf7f657dc76e7c6d2
Author: Patrice Dumas <pertusus@free.fr>
AuthorDate: Fri Dec 30 00:42:06 2022 +0100

    * doc/texi2oldapi.texi: add information in comments on how to
    process in source.  Fix to be processable.  More prominently
    state that the API description is obsolete and dates from 2010/2012.
---
 ChangeLog            |  6 ++++++
 doc/texi2oldapi.texi | 28 ++++++++++++++++++++++++----
 2 files changed, 30 insertions(+), 4 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index cc2a4cb7e9..139605928e 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2022-12-29  Patrice Dumas  <pertusus@free.fr>
+
+       * doc/texi2oldapi.texi: add information in comments on how to
+       process in source.  Fix to be processable.  More prominently
+       state that the API description is obsolete and dates from 2010/2012.
+
 2022-12-29  Patrice Dumas  <pertusus@free.fr>
 
        * doc/texinfo.texi (@command{texi2html}): remove reference to
diff --git a/doc/texi2oldapi.texi b/doc/texi2oldapi.texi
index 0691d8c8d2..89c8c7ac86 100644
--- a/doc/texi2oldapi.texi
+++ b/doc/texi2oldapi.texi
@@ -1,3 +1,4 @@
+\input texinfo.tex
 @c history and some customization sections from the texi2html manual
 @c (only partly edited), excised.
 @c
@@ -12,13 +13,21 @@
 @c   Foundation, Inc.
 @c
 @c See texinfo.texi for copying conditions.
+@c
+@c can be converted in source with:
+@c TEXINDEX=${top_builddir}/../../../../texindex/texindex ; export TEXINDEX ; 
TEXINDEX_SCRIPT=${top_srcdir}/../../../../texindex/texindex.awk ; export 
TEXINDEX_SCRIPT ; ../util/texi2dvi --pdf texi2oldapi.texi 
--build-dir=texi2oldapi.t2p
+@c
+@c ../tp/texi2any.pl --no-validate texi2oldapi.texi
+
+@contents
 
 @node Top
 @top Archived information on Texi2HTML and early texi2any API
 
-The early texi2any API has been obsoleted by the texi2any_api
+The early texi2any API described in @ref{texi2any Output Customization}
+dates back to 2010/2012 and has been obsoleted by the texi2any_api
 manual (@pxref{,,, texi2any_api, GNU Texinfo @command{texi2any}
-Output Customization}}).
+Output Customization}).
 
 @node Texi2HTML
 @appendix Texi2HTML history and relations with @command{makeinfo}
@@ -359,7 +368,16 @@ behaviour. Enclosing in @code{@@ifnothtml} would be much 
cleaner.
 
 
 @node texi2any Output Customization
-@chapter @command{texi2any} Output Customization
+@appendix @command{texi2any} Output Customization
+
+@cartouche
+@quotation Warning 
+This early texi2any API described here
+dates back to 2010/2012 and has been obsoleted by the texi2any_api
+manual (@pxref{,,, texi2any_api, GNU Texinfo @command{texi2any}
+Output Customization}).
+@end quotation
+@end cartouche
 
 @cartouche
 @quotation Warning
@@ -431,7 +449,8 @@ All @file{Config} files found are loaded, in the above 
order.  Thus,
 @file{./Config} can override entries in, say,
 @file{/usr/local/share/makeinfo/Config}.
 
-@opindex --init-file
+@c @opindex --init-file
+@cindex @option{--init-file}
 However, the most common way to load an initialization file is with
 the @option{--init-file} option, explicitly specifying the file to be
 loaded.  By default the following directories are searched, in the
@@ -5008,3 +5027,4 @@ and @var{$message}, if defined is a message outputted to 
the output
 with line number added by @command{texi2any}.
 @end deftypefn
 
+@bye