[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
texinfo ChangeLog NEWS doc/texinfo.txi
From: |
Karl Berry |
Subject: |
texinfo ChangeLog NEWS doc/texinfo.txi |
Date: |
Sun, 25 Jul 2010 00:24:53 +0000 |
CVSROOT: /sources/texinfo
Module name: texinfo
Changes by: Karl Berry <karl> 10/07/25 00:24:53
Modified files:
. : ChangeLog NEWS
doc : texinfo.txi
Log message:
texi2any edit/proofread start
CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/texinfo/ChangeLog?cvsroot=texinfo&r1=1.1071&r2=1.1072
http://cvs.savannah.gnu.org/viewcvs/texinfo/NEWS?cvsroot=texinfo&r1=1.195&r2=1.196
http://cvs.savannah.gnu.org/viewcvs/texinfo/doc/texinfo.txi?cvsroot=texinfo&r1=1.265&r2=1.266
Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/texinfo/texinfo/ChangeLog,v
retrieving revision 1.1071
retrieving revision 1.1072
diff -u -b -r1.1071 -r1.1072
--- ChangeLog 24 Jul 2010 21:14:38 -0000 1.1071
+++ ChangeLog 25 Jul 2010 00:24:52 -0000 1.1072
@@ -1,3 +1,8 @@
+2010-07-24 Karl Berry <address@hidden>
+
+ * doc/texinfo.txi (Generic translator texi2any/makeinfo): rename
+ from "Generic converter", edit chapter intro.
+
2010-07-24 Patrice Dumas <address@hidden>
* doc/texinfo.txi (Initialization files basics): merge `Function
Index: NEWS
===================================================================
RCS file: /sources/texinfo/texinfo/NEWS,v
retrieving revision 1.195
retrieving revision 1.196
diff -u -b -r1.195 -r1.196
--- NEWS 18 Jul 2010 18:49:02 -0000 1.195
+++ NEWS 25 Jul 2010 00:24:52 -0000 1.196
@@ -1,4 +1,4 @@
-$Id: NEWS,v 1.195 2010/07/18 18:49:02 karl Exp $
+$Id: NEWS,v 1.196 2010/07/25 00:24:52 karl Exp $
This NEWS file records noteworthy changes, very tersely.
See the manual for detailed information.
@@ -32,8 +32,9 @@
. DEL (0x7f = 0177 = 127) is a true comment character (catcode 14 in TeX).
* texi2html:
- . new program, replacing and upward-compatible with makeinfo, but
- with many additional features. See texi2html/NEWS for its own changes.
+ . 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.
* texinfo.tex:
. support some per-language hyphenation, when the underlying TeX
@@ -41,6 +42,10 @@
later). Words with accented letters are still not handled properly.
. new Icelandic translation: txi-is.tex.
+* texi2any:
+ . new generic converter that can produce all supported output formats,
+ both those from texi2dvi (PDF/DVI) and from makeinfo (Info/HTML/etc.).
+
* texi2dvi:
. new option --max-iterations.
Index: doc/texinfo.txi
===================================================================
RCS file: /sources/texinfo/texinfo/doc/texinfo.txi,v
retrieving revision 1.265
retrieving revision 1.266
diff -u -b -r1.265 -r1.266
--- doc/texinfo.txi 24 Jul 2010 21:14:38 -0000 1.265
+++ doc/texinfo.txi 25 Jul 2010 00:24:53 -0000 1.266
@@ -1,5 +1,5 @@
\input texinfo.tex @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.265 2010/07/24 21:14:38 pertusus Exp $
address@hidden $Id: texinfo.txi,v 1.266 2010/07/25 00:24:53 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.
@@ -160,7 +160,7 @@
* Defining New Texinfo Commands:: User-defined macros and aliases.
* Include Files:: How to incorporate other Texinfo files.
* Hardcopy:: Output for paper, with @TeX{}.
-* Generic converter texi2any/makeinfo:: The all purpose converter.
+* Generic translator texi2any/makeinfo:: The all purpose converter.
* Creating and Installing Info Files:: Details on Info output.
* Generating HTML:: Details on HTML output.
* texi2any output customization:: Fine tuning with initialization files.
@@ -601,7 +601,7 @@
* PDF Output:: Portable Document Format output.
* Obtaining TeX:: How to Obtain @TeX{}.
-Generic converter texi2any/makeinfo
+Generic translator texi2any/makeinfo
* Invoking texi2any:: How to run @command{texi2any} and
@command{makeinfo}
from a shell.
@@ -3212,7 +3212,7 @@
You may wish to include titlepage-like information for plain text
output. Simply place any such leading material between
@code{@@ifplaintext} and @code{@@end ifplaintext}; @command{makeinfo}
-includes this when writing plain text (@samp{--plaintext}), along with
+includes this when generating plain text (@samp{--plaintext}), along with
an @code{@@insertcopying}.
@menu
@@ -5184,9 +5184,9 @@
The node to which a pointer points may come before or after the
node containing the pointer.
address@hidden
@cindex @@-commands in nodename
@cindex Node name, should not contain @@-commands
address@hidden
@@-commands in node names are not allowed. This includes punctuation
characters that are escaped with a @samp{@@}, such as @code{@@} and
@address@hidden, and accent commands such as @samp{@@'}. Perhaps
@@ -15918,32 +15918,44 @@
Many other @TeX{} distributions are available; see
@uref{http://tug.org/}.
address@hidden Generic converter texi2any/makeinfo
address@hidden A generic converter for Texinfo:
@command{texi2any}/@command{makeinfo}
address@hidden is a generic converter for Texinfo that can produce
-different output formats and is highly customizable.
-By default, the formats that may be produced are
-Info (with @option{--info}), HTML (with
address@hidden), plain text (with @option{--plaintext}), Docbook
-(with @option{--docbook}), Texinfo XML (with @option{--xml}).
address@hidden is an alias of @command{texi2any}, and using this command
-is the same as using @code{texi2any --info}.
-
-Without any command line option, @command{texi2any} generates raw text with
-minimal formatting, well suited for customization. It is not advised to
-use this output format to generate documents, however, since it is
-very basic. You should produce plain text instead, with
address@hidden Generic translator texi2any/makeinfo
address@hidden A generic translator for Texinfo:
@command{texi2any}/@command{makeinfo}
+
address@hidden is a generic translator for Texinfo that can
+produce different output formats and is highly customizable. By
+default, the formats that may be produced are:
+
address@hidden @asis
address@hidden Info (with @option{--info}),
+
address@hidden HTML (with @option{--html}),
+
address@hidden plain text (with @option{--plaintext}),
+
address@hidden Docbook (with @option{--docbook}),
+
address@hidden Texinfo XML (with @option{--xml}).
address@hidden table
+
address@hidden is an alias of @command{texi2any}, and using this
+command is the same as using @code{texi2any --info}.
+
+Without any command line option, @command{texi2any} generates raw text
+with minimal formatting, which may be suitable for further processing.
+We do not recommend using this output format for actual documentation,
+since it is so basic. Instead, produce plain text with
@option{--plaintext}.
-Beside those default formats, with @command{texi2any} some important
-aspects of the result may be specified via command line options,
-and initialization files provide an even finer degree of control
-over the final output, allowing most every aspect of the final output not
-specified in the Texinfo input file to be specified. Initialization files are
-written in @command{perl}, like the main program, and anything which may be
-specified on the command line may also be specified within a initialization
-file.
+Beside these default formats, command line options to
address@hidden can determine important aspects of the output.
+Beyond that, initialization files provide an even finer degree of
+control over the final output, including nearly every aspect not
+specified in the Texinfo input file. Initialization files are written
+in Perl, like the main program, and anything which may be specified on
+the command line may also be specified within a initialization file.
+
+The rest of this chapter gives further details on the program.
@menu
* Invoking texi2any:: How to run @command{texi2any} or
@command{makeinfo}
@@ -15952,6 +15964,7 @@
* makeinfo Configuration Variables:: Description of configuration variables.
@end menu
+
@node Invoking texi2any
@section Running @command{texi2any}/@code{makeinfo} from a Shell
@pindex makeinfo
@@ -23674,7 +23687,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.265 2010/07/24 21:14:38 pertusus Exp $
+$Id: texinfo.txi,v 1.266 2010/07/25 00:24:53 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}
@@ -23753,7 +23766,7 @@
@verbatim
\input texinfo @c -*-texinfo-*-
address@hidden $Id: texinfo.txi,v 1.265 2010/07/24 21:14:38 pertusus Exp $
address@hidden $Id: texinfo.txi,v 1.266 2010/07/25 00:24:53 karl Exp $
@comment %**start of header
@setfilename sample.info
@include version.texi
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- texinfo ChangeLog NEWS doc/texinfo.txi,
Karl Berry <=