bootstrapping.
*** NEWS FOR ALL AUTHORS OF TEXINFO MANUALS ***
As of version 4.2, Texinfo has a new command @copying to define the
copyright and copying permissions for a manual. If you haven't already,
please switch to using it in your next release, because the historical
method of doing copyright permissions using @ifinfo failed to output
copyright information in the HTML (or XML) formats. The manual has
detailed explanations and examples. For convenience, here's a url to
one of the relevant sections:
http://www.gnu.org/software/texinfo/manual/texinfo/html_node/Document-Permissions.html
-------------------------------------------------------------------------------
5.1 (12 March 2013)
* texi2any:
. irregular sectioning trees (see 5.0 news item) produce a warning
rather than an error.
. @set in the middle of the line no longer produces a warning.
* info:
. lzip (.lz) compression supported.
* install-info:
. lzip (.lz) compression supported.
5.0 (16 February 2013)
* Language:
. Texinfo commands are supported in node names.
. #line directives are recognized.
. @-commands are now recognized in raw format blocks. Therefore, for
example, lone @, { and } characters in @tex, @html and similar
environments must be converted to the normal @@, @{, and @} commands.
. new commands @inlinefmt and @inlineraw for brace-delimited conditionals.
. new conditionals @ifcommanddefined and @ifcommandnotdefined to test
if a Texinfo command is available.
. new command @part for a group of chapters.
. new environments @raggedright, @smallquotation,
@indentedblock, and @smallindentedblock.
. new commands @codequoteundirected and @codequotebacktick,
for a better interface than the @set variables; now respected by @kbd.
. new command @xrefautomaticsectiontitle to allow using section titles
in cross references by default, instead of node names.
. new commands for Texinfo special characters:
@atchar{} @lbracechar{} @rbracechar{} @backslashchar{} @hashchar{}.
. new commands @deftypefnnewline to print return types on their own lines.
. new command @headitemfont for the sake of template rows.
. new command @urefbreakstyle to control breaking of @url/@uref in TeX.
. new diacritic command @ogonek.
. new commands for Icelandic letters eth and thorn: @DH{} @dh{} @TH{} @th{}.
. new command @errormsg to report an error.
. five-argument xrefs can refer to a whole manual, by omitting the
section name and either omitting the node name or using "Top".
. DEL (0x7f = 0177 = 127) is a true comment character (catcode 14 in TeX).
* texi2any is the new generic converter for Texinfo that can produce all
supported output formats, both those from texi2dvi (PDF/DVI) and from
makeinfo (Info/HTML/etc.). texi2any and makeinfo are now different
names for the same program; there are no differences in behavior based
on the program name.
The new implementation is in Perl, requiring Perl 5.7.3 (released in
March 2002) and its standard Encode module.
The Perl texi2any/makeinfo both replaces and is intended to be (for
all practical purposes) upward-compatible with the C makeinfo. It has
many new features not in the C makeinfo. For example, cross-manual
references are now fully supported, and allows for extensive
customization of the HTML output. See the `Generic Translator
texi2any' chapter in the manual (among other places) for more about
this reimplementation.
The new program is, unfortunately, noticeably slower at present than
the C program was. We hope all the many improvements make the new
version worthwhile for users nevertheless.
* Intentional incompatibilities with the previous implementation of
makeinfo, through version 4.13:
. The old implementation accepted a lone block of text inside @itemize,
@enumerate, etc., without any @item. This is semantically
inconsistent, leading to problems with some backends, and thus now
produces a warning.
. The old implementation accepted ``irregular'' sectioning trees. Now,
when @node pointers are implicitly determined, the consistency of
@menu and the sectioning tree is checked. (If node pointers are
explicitly specified in the document, the tree can still be irregular.)
. The old implementation always added blank lines between function
definitions if they weren't already there. Now blank lines are not
added. (Both old and new implementations preserve blank lines that
are present.)
. The old implementation did not consider ends of lines from expansion
of an @macro definition to end an @-command line-delimited argument
(@chapter, @center, etc.). This is no longer the case. (A detailed
example is in the manual, node Macro Details.)
* pod2texi is a new (Perl) program that uses the capabilities of
texi2any to translate Perl pod documentation to Texinfo.
* texinfo.tex:
. urls (given to @uref and @url) are broken by default at special
characters; behavior controllable with @urefbreakstyle.
. support some per-language hyphenation, when the underlying TeX
engine does (for instance, etex/pdfetex from TeX Live 2008 or
later). Words with accented letters are still not handled properly.
. @title, text will be broken if needed, and @* can be used to override.
. new Icelandic translation: txi-is.tex.
. new Hungarian translation: txi-hu.tex.
. official updates between full package releases available at
http://ftpmirror.gnu.org/texinfo/texinfo.tex.
* texi2dvi:
. new option --max-iterations.
. official updates between full package releases available at
http://ftpmirror.gnu.org/texinfo/texi2dvi.
* info:
. INFOPATH is determined from PATH by default, or if an element "PATH"
is specified.
. New command Info-virtual-index, bound to I by default, following Emacs.
. Info keywords not found by searches.
. A lower limit on the length of search patterns, default 1,
specified by the variable min-search-length.
. Use ASCII versions of images, if supplied by the document.
. xz compression supported.
* install-info:
. xz compression supported.
* Documentation:
. new appendix with a technical description of the Info file format.
. information on the customizations of the HTML output now possible.
* Distribution:
. new file htmlxref.cnf is installed to support cross-manual
references; official updates between full package releases available
at http://ftpmirror.gnu.org/texinfo/htmlxref.cnf.
. language support for no removed/renamed to nb, per Norwegian translators.
. new translations: id it,
and document translations: eo pl.
. texinfo.cat file removed since it is (to our knowledge) unused.
. documentation license now GFDLv1.3 or later.
. autoconf 2.69, automake 1.13.1, gettext 0.18.2.
test for whether "local" works. Now ksh93 is correctly detected as
a shell that does not have a working 'local' command.
Use REPLACE_SH to edit the #!/bin/sh line in util/texi2dvi, to make
it use the value of ${SH} instead of /bin/sh.
Set PKGREVISION=1.
4.13 (18 September 2008)
* A reference card for Texinfo is now available, in doc/refcard. For
convenience, preformatted PDF's for letter-size and A4 paper are included.
* makeinfo:
. new option --internal-links for HTML output, to write a tsv file
mapping indexed/toc terms to links, for easy reference from external
documents.
. - as an input file name reads standard input.
* info:
. support for multibyte encodings such as UTF-8.
. new option --show-malformed-multibytes, to display malformed multibyte
sequences.
. new environment variable INFO_MAN_COMMAND sets the name of man binary
(use it if you a need to override PATH settings).
* install-info:
. bug fix: support names with embedded periods (e.g., config.status) again.
* Distribution:
. autoconf 2.63.
Suggest installing pdftex/pdflatex for PDF support.
Based on suggestion from Jeremy C. Reed and patch by Aleksey Cheusov.
Remove EXTRACT_SUFX, it was at its default.
gtexinfo only needs the t*() termcap functions (info/terminal.c).
+ Drop patch-ad. The custom termcap code it added is now automatically
handled by termcap.buildlink3.mk. Also the modification to the
function signature for output_character_function is wrong -- tputs
does expect "int (*)(int)".
Bump the PKGREVISION to 1.
Based on patch provided by Magnus Henoch in PR 37481.
I made some modification:
* keep and update patch-ac (need to pick up pkgsrc info files).
* fixes PLIST, missing some entries.
* portability fix in texi2dvi (patch-am).
* DESTDIR support.
Changes:
4.11 (9 September 2007)
* Language:
. @documentlanguage now supports an optional country code
specification after the language code, a la gettext.
. new command @allowcodebreaks controls breaks at _ and - within @code.
. new command @frenchspacing controls spacing after sentences.
. new command @fonttextsize allows changing body text font size to 10pt.
. new command @textdegree{} produces the normal degrees symbol.
. new command @thischapternum can be used in TeX headers/footers.
. new commands for quotes: @quotedblleft @quotedblright
@quoteleft @quoteright @quotedblbase @quotesinglbase
@guillemetleft @guillemetright @guilsinglleft @guilsinglright.
. new option @set txicodequoteundirected produces an undirected quote
in code and example output, instead of the regular right quote.
. new option @set txicodequotebacktick produces a grave accent in
code and example output, instead of the regular left quote.
* makeinfo:
. The @documentlanguage locale is used to translate various document strings.
. --enable-encoding is now the default, meaning Info and plain text
output use 8-bit characters given a supported @documentencoding.
. new option --css-ref=URL for creating a stylesheet <link> in HTML output.
. new option --transliterate-file-names to use a reduction-to-ASCII
algorithm for split HTML file names, useful for non-Latin-based languages.
. @enddots{} outputs three dots instead of four, for consistency with
texinfo.tex.
. the Local Variables coding: setting written by --enable-encoding now
comes at the very end, after the tags table, so that Emacs can find
it in more cases.
. @allow-recursion (never documented) is deprecated and produces a warning.
. @quote-args (never documented) is now the default behavior.
. centering and such take account of character widths.
. the --reference-limit option is now a no-op.
. improvements to XML and Docbook output and the DTD.
* texinfo.tex:
. @thissection can now be used in custom headings, and @thischapter
works reliably even without @set chapternewpage. Custom headings
have additional flexibility as well.
* texi2dvi:
. pdftexi2dvi is a new wrapper to `texi2dvi --pdf', equal to texi2pdf,
for the sake of AUC-TeX which prepends `pdf' to the compilation
command when requested to produce PDF.
* info:
. look for info files in the current directory first, by default.
. when calling man, use -a if no explicit section is found.
. avoid showing the top(1) man page for nonexistent info files.
* install-info:
. new options --section-regex, --remove-exactly, --debug, --test.
* Distribution:
. autoconf 2.60, automake 1.10, gettext 0.16.1.
. gettext support now [external].
. new translations: hu (Hungarian), rw (Kinyarwandan), vi (Vietnamese).
. most common sources imported from gnulib.
4.10 (omitted)
4.9 (29 June 2007)
* GPLv3.
* texi2dvi:
. new mode --build=tidy which supports compilation in a separate
directory, where intermediate files are preserved.
. new option --build-dir, to specify where the tidy build will take
place, either locally or globally. This allows avoiding the clutter
while preserving auxiliary files.
. new support for AUC-TeX: texi2dvi (weakly) supports arguments a la
TeX such as `\nonstopmode\input{file.tex}'.
. new options --ps and --dvipdf, useful especially for pstricks documents.
. new option --src-specials, passed to TeX.
* texinfo.tex:
. Latin1, Latin2, Latin9, and UTF-8 are supported -- only as well as
the Computer Modern fonts can manage, which means primarily English
and western European languages, to a limited extent.
. png and jpg images supported in pdf output.
. new Russian, Serbian, and Ukrainian translations for texinfo.tex:
txi-ru.tex, txi-sr.tex, txi-uk.tex.
. section names with \ characters work properly in pdf outlines.
. have .toc files use @ as the escape character, instead of \.
warnings.
===> GCC
texindex.c: In function `readline':
texindex.c:848: warning: assignment makes pointer from integer without a cast
===> MIPSpro
cc-1515 cc: ERROR File = texindex.c, Line = 848
A value of type "long" cannot be assigned to an entity of type "char *".
end = buffer - linebuffer->buffer;
Well, if the compilers were more intelligent, they could have seen that
(buffer == linebuffer->buffer) was an invariant and that the resulting
difference was therefore always zero, and zero can be converted into any
pointer type. ;)
(a) to generate a new tempory file name -> O_EXCL logic applies here
(b) to regenerate the name of an older temporary file for removal
-> don't create or even open the file here, just remove it.
Discussed with salo@.
4.8 (31 December 2004)
* Language:
. new command @euro for the Euro currency symbol, and
@documentencoding has some support for ISO-8859-15.
. new command @abbr for general abbreviations.
. new command @slanted to typeset text in a slanted font,
and @sansserif to typeset in a sans serif font.
* makeinfo:
. An empty first argument to cross-reference commands, such as @xref,
causes an error. This change was made in 4.1, but not mentioned in NEWS.
. HTML output:
- <a name="..."> constructs are added for the old-style
conversion of node names to HTML names, so that external references
to them can continue to work.
- "g_t" prefixed to targets for node names beginning with a
nonletter, for XHTML compatibility.
. Docbook output: recognize more image formats.
* texi2dvi:
. new option --recode, to call recode for input character translation.
* Distribution:
. new convenience script texi2pdf, equivalent to texi2dvi --pdf (from tetex).
[not installed by package to avoid conflicting with teTeX-bin]
. some cross-compiling support in configure && make.
. new configure option --disable-install-warnings, for TeX.
distributions which do have the files installed.
. automake 1.9.4.
4.7 (9 April 2004)
* Language:
. new commands @float, @caption, @shortcaption, @listoffloats for
initial implementation of floating material (figures, tables, etc).
Ironically, they do not yet actually float anywhere.
. new commands @docbook, @ifdocbook, @ifnotdocbook for conditional Docbook.
. new commands @ordf{} and @ordm{} for Spanish feminine/masculine ordinals.
. new commands @deftypecv[x] for class variables in typed OO languages.
. new command @registeredsymbol for the r-in-a-circle symbol.
. new command @headitem to make a heading row in @multitable.
. new command @LaTeX{} for the LaTeX logo.
. new command @comma{} to avoid comma-parsing problems.
. @url is now a synonym for @uref; new command @indicateurl has the
old meaning of just displaying a url as text.
. @quotation now accepts an optional argument for labelling the text
as a `Note', `Tip', etc.
. @defun (et al.) heading lines can now be continued with a lone @.
. @acronym accepts an optional argument for the meaning of the acronym.
* makeinfo:
. New environment variable TEXINFO_OUTPUT_FORMAT determines the output
format at runtime, if no options are specified.
. New option --plaintext, equivalent to --no-headers with Info output.
. All outputs:
- sections are numbered by default.
. Info output:
- punctuation is inserted after @pxref and @ref, if needed to make
cross-references valid.
- line numbers included in index menus, so Info readers can go to
the exact line of an entry, not just a node. Also in plaintext output.
- ^@^H[index^@^H] cookie included in index menus, so Info readers
can handle the ] etc. commands better.
. HTML output:
- new algorithm for cross-references to other manuals, for maximum
portability and stability.
- include node name in <title> with split output.
- @multicolumn fractions become percentages.
- entities used for bullets, quotes, dashes, and others.
- index entries are links to the exact locations.
- <h4> and <h5> used for @sub and @subsubsections again.
- accented dotless i supported.
. XML output: many new tags and structure to preserve more source features.
. Docbook output:
- upgraded DTD to Docbook XML 4.2, no longer using Docbook SGML.
- improved translation in general, for instance:
- line annotations and marked quotations.
* texi2dvi:
. if available, use etex (pdfetex if --pdf) by default.
. if the input file includes thumbpdf.sty (for LaTeX), then run thumbpdf.
. more output if --debug.
* texinfo.tex:
. @defun names are now printed in typewriter (instead of bold), and
within the arguments, @var text is printed in slanted typewriter.
. @tex code is executed inside a TeX group, so that any changes must
be prefixed with \global (or the equivalent) to be effective. (This
change was actually made years ago, but never made it into the NEWS.)
* info:
. new option --where (aka --location, -w) to report where an Info file
would be found, instead of reading it.
. by default, output ANSI terminal escape sequences as-is; new option
--no-raw-escapes overrides this.
. use the newly-generated index line numbers.
* Distribution:
. new script gendocs.sh (not installed), for use by GNU maintainers in
getting their manuals on the GNU web site. Documented in
maintain.texi (http://www.gnu.org/prep/maintain_toc.html).
. Most code uses ANSI C prototypes, to some extent.
. New translation: nb.
. automake 1.8.3, autoconf 2.59, gettext 0.14.1.
for a terminal library.
[in an ideal world, ncurses wouldn't even be listed, but according
to the comments in configure.ac, some Linux distributions don't have
libcurses, only libncurses, so it should stay.]
fixes a problem when building with an external gcc, since gcc, when
installed into /prefix, unconditionally searches /prefix/lib for
libraries at link time causing it to find libncurses in /prefix/lib
(the normal gcc ugliness). this leads to the runtime linker being
unable to find libncurses.
noted by gavan@, fix tested by gavan@ and myself.
to maintain conistency of the generated files as currently required
by pkgsrc.
bump PKGREVISION.
(perhaps info files will be automatically added to the PLIST in the
future?)
Package changes: fix PKGLOCALEDIR botch reported by various people. Many
thanks to Lubomir Sedlacik <salo at Xtrmntr dot org> for the patches in
PR 18616!
Changes in version 4.3:
4.3 (14 November 2002)
* Language:
. new command @tie{} to do a real tie (unbreakable interword space).
* makeinfo:
. html output for @defun and friends now has font changes.
. html output has some class attributes.
* texinfo.tex:
. new Italian translations, txi-it.tex.
. pdf bookmarks for unnumbered sections work.
. type name for @defun and friends no longer extends into margin.
* info:
. automatic-footnotes now off by default, for emacs compatibility.
. crash when MALLOC_CHECK_=2 fixed.
* install-info:
. new option --infodir synonym for --info-dir, for compatibility with
the Debian install-info.
. support for bzip2-compressed files.
* texindex:
. omit initial if the entire index is under one characters.
* Distribution:
. development sources now available under CVS, see
http://savannah.gnu.org/projects/texinfo/
. Turkish message translation.
. gettext 0.11.5, autoconf 2.54, automake 1.7.1.
buildlink1 -> buildlink2.
Changes:
*** IMPORTANT NEWS FOR ALL AUTHORS OF TEXINFO MANUALS ***
As of version 4.2, Texinfo has a new command @copying to define the
copyright and copying permissions for a manual. It's important to
switch to using it as soon as possible (as in your next release),
because the historical method of doing copyright permissions using
@ifinfo failed to output copyright information in the HTML (or XML)
formats. The manual has detailed explanations and examples. For
convenience, here's a url to one of the relevant sections:
http://texinfo.org/manual/Document-Permissions.html
4.2 (1 April 2002)
* Language:
. new command @copying to define copying permissions. See above.
. new conditionals @ifplaintext, @ifnotplaintext for the plain text
(--no-headers) output format.
. new command @\ to produce literal \ inside @math, since \ by itself
no longer works.
* makeinfo:
. emit accesskey attributes for keyboard shortcuts to menu items.
. @{even,every,odd}{footing,header} are ignored by makeinfo now, so
they no longer need to be enclosed in @iftex.
* texinfo.tex:
. bug fix for pdf-format table of contents.
* info:
. bug fixes for -R (--raw-escapes).
. --help shows short option names.
* Distribution:
. the doc.c, funs.h, and key.c files in info/ are no longer generated
at make time, to appease Automake's make distcheck.
. gettext 0.11.1, autoconf 2.53, automake 1.6 (with install-info kludge).
4.1 (4 March 2002)
* Language:
. new commands @verbatim and @verb for printing verbatim inserts.
. new command @verbatiminclude for verbatim include of files.
. new environment @documentdescription for defining the HTML description.
. new command @afivepaper for the A5 paper size.
* makeinfo:
. supports xml and docbook output.
. supports HTML splitting by node, which is now the default.
. new option --split-size to control maximum size of split info files.
* info:
. user-specified key bindings supported.
. ANSI escape sequences (as produced by groff) removed from man output
by default; use --raw-escapes to let them through if your terminal
supports them.
* texinfo.tex:
. @math implies @tex, so all the usual plain TeX math is supported.
. smaller fonts for @smallexample, in all page sizes.
. improvements in the PDF support.
* texi2dvi:
. new option -o to explicitly specify output filename.
* Distribution:
. switch to GNU Free Documentation License (http://www.gnu.org/copyleft/).
. update to GNU gettext 0.11, autoconf 2.52, and automake 1.5.
. Danish, Swedish, and Hebrew message translations.
* Language:
. New command @anchor for cross references to arbitrary points.
. New commands @documentlanguage sets the main document language,
and @documentencoding sets the document input encoding (although not
much is done yet with either).
. New command @pagesizes allows limited control of text area for typesetting.
. New command @acronym for abbreviations in all caps, such as `NASA'.
. New command @alias for simple command aliases.
. New command @definfoenclose for better control of info output.
. New commands @deftypeivar for typed instance variables of a class
and @deftypeop for typed operations of a class.
. New command @novalidate suppresses cross-reference checking and (in
TeX) auxiliary file creation.
. New commands @setcontentsaftertitlepage and
@setshortcontentsaftertitlepage to force printing the table of
contents after @end titlepage. Also, @contents and @shortcontents
themselves can now appear at the beginning of the document as
well as the end.
. New markup commands: @env (for environment variables), @command (for
command names), @option (for command-line options).
. New commands @smallformat and @smalldisplay, a la @smallexample.
. New command @exampleindent to set indentation of example-like
environments a la @paragraphindent.
. @uref takes an optional third argument of text to show instead of
(rather than in addition to) the url for info and dvi output.
. @footnote works in an @item for a @table.
* texinfo.tex:
. implements @macro.
. implements @paragraphindent (except asis).
. @emph and @i use true italic type (cmti) instead of slanted (cmsl).
. implements pdf output when run with pdftex.
. better support for internationalization via txi-??.tex files.
* makeinfo:
. supports HTML output with the --html option.
. implication of --html: @top nodes should be wrapped in @ifnottex
rather than @ifinfo. @ifinfo conditionals are not expanded with --html.
. new option --number-sections to output chapter/section numbers.
. dashes and quotes are not treated specially in node names.
. new option --commands-in-node-names to allow @-commands in node names.
(Not implemented in TeX, and most likely never will be.)
. @emph output uses _underscores_.
. @image looks for .png files before .jpg.
. only output `Making ... file' line when verbose.
. allow -v as synonym for --verbose.
. new command line options to specify which conditionals to process
(but --iftex is not fully implemented).
. warns if @var contains any of ,[]().
. @quote-arg implicitly done for all one-argument macros, so commas in
the argument text are allowed.
. \\ required in macro body to get single \, no other `escapes' defined.
* info:
. ISO Latin 1 characters are displayed and input as-is by default.
. new option --vi-keys to enable vi-like and less-like key bindings.
. new command S does case-sensitive searching.
. new commands C-x n and C-x N repeat last search, respectively, in the
same and in reverse direction, without prompting for the string. These
commands are bound to n and N under --vi-keys, like in Less.
. new command G menu1 menu2 ... searches for menu items from (dir),
as allowed on the command line.
. new command O (capital o, not zero) goes directly to the node that
describes command-line options.
. new command-line option --show-options causes the node which
describes command-line options to be the first node displayed.
. M-prior and M-DEL do new command info-scroll-other-window-backward.
. / searches like s does.
. If the search string includes upper-case letters, in both incremental
and non-incremental search, the search is case-sensitive.
. S searches case-sensitively even if the search string is all
lower-case.
. - makes the argument negative (so e.g. `- /' searches backward).
. l restores point in the window returned to.
. SPC/DEL do not move outside the current document.
. foo.info is found before foo.
. `info foo --index-search=bar' now searches for bar in foo's index.
. support for files compressed with bzip2.
* install-info:
. handles gzipped dir files.
. sort entries into alphabetical order.
. install direntries only in preceding dircategory, not in all.
. --delete does not require the info file to exist.
. --delete can handle XEmacs-style dir entries.
* texi2dvi:
. bug fixed: now uses only the @iftex and @tex parts of the source.
. process LaTeX source as well as Texinfo source.
. output PDF (using pdftex) with new option --pdf.
. handles --OPTION=ARG style of command line arguments.
. new option --batch for progress reports but no interaction.
. new option --clean to remove all auxiliary files.
. new option --quiet for silence (unless there are errors).
. new option -I for specifying directories for @include to search.
. handles LaTeX files (running BibTeX etc.).
* Fixes to util/gen-dir-node and util/fix-info-dir (formerly util/update-info).
This is necessary because NetBSD has no default way of reading GNU info
files - FreeBSD has had this in their base system since 2.2.2. This
allows the default installation of package's info files, and means
less differences between individual package's Makefiles in NetBSD and
FreeBSD.
`Renamed' to gtexinfo to distinguish it from the print/texinfo package.
