Changelog:
6.7 (23 September 2019)
* Language:
. support of index subentries and sub-subentries with @subentry
. new commands @seeentry and @seealso in index entries
. no need to wrap Top node in @ifnottex - omitted automatically when
processed with TeX
. UTF-8 is the default input encoding
* texi2any
. for HTML output, mark index nodes in menus and tables of contents
with the 'rel' attribute of the 'a' tag.
. TOP_NODE_UP is now only used in HTML if TOP_NODE_UP_URL is set.
Also TOP_NODE_UP should now be formatted in the output format.
In HTML TOP_NODE_UP should be suitable for inclusion in HTML
element attributes, so for instance should not contain elements.
. support of noderename.cnf files has been removed
. INPUT_PERL_ENCODING, INPUT_ENCODING_NAME, NODE_FILE_EXTENSION,
NODE_FILENAMES, SHORTEXTN and TOP_NODE_FILE removed as customization
variables.
. TOP_NODE_FILE_TARGET now contains the extension.
. error messages translated when the XS parser module is in use
* texi2dvi
. unconditionally run in --batch mode, i.e. without stopping if there
is a TeX error
. keep on going after a TeX error if the index files changed
. with --tidy (or --build-dir), avoid reading index files from previous
runs where --tidy was not used
* info
. for a tree search (with M-/), '}' and '{' work as well as 'M-}' and
'M-{' to go through the results
* Distribution:
. Several obsolete portability checks removed
. gettext 0.20.1, automake 1.16.1
6.6 (16 February 2019)
* Language:
. new commands @&, @ampchar{}
. @cropmarks command removed
. @ctrl is no longer recognised (it was a way to insert literal
control characters in Info files, but deprecated since the
time of Texinfo version 2)
. \usebracesinindexestrue is no longer recommended for using braces in
index entries, and has been a no-op for some time
* texi2any
. extension modules fixed to work with the "thread-safe locales" of
Perl 5.28 and newer
. some code changed to stop warnings being given by newer versions of Perl
. for HTML output, use `id' to define link targets instead of the `name'
attribute on <a>
. A native-code implementation of the Texinfo parser has been included
on an experimental basis, which makes texi2any a lot faster. Set the
`TEXINFO_XS_PARSER' environment variable to 1 to use.
. changes to HTML output:
. omit colon after node name in menus by default (use
`MENU_ENTRY_COLON' to add it back)
. no special CSS for commands like @smallexample
. new customization variable `SECTION_NAME_IN_TITLE' to use the
section name as the document <title>
. use section names instead of node names in generated menus
. pass on flags set with -D to TeX
. useless static libraries are not installed
. the newline after an @insertcopying is not output
. warning given for @multitable prototypes not in braces
. @indent and @noindent are not allowed inside the arguments to
commands where they are not meaningful
. @quote-arg and @allow-recursion are not recognised (these two used
to be recognised by makeinfo in macro definitions but were never
implemented in texinfo.tex)
. `FIX_TEXINFO' removed as a customization variable
. do not recognise or warn about obsolete customization variables
* info
. debugging output with -x is not diverted to a separate infodebug file
* Development:
. switch from Subversion to git
- https://savannah.gnu.org/git/?group=texinfo
. automake 1.16
When the check was enabled, the sub-configure for the Perl modules didn't
know some options and failed. This in turn disabled the Perl modules from
being installed, but the PLIST mentions them unconditionally.
Changelog:
6.5 (12 September 2017)
* info:
. some bugs fixed:
. a bug where a segfault could happen in the regex search, for
example when the user entered a single \ as the search string
. another bug which could make nodes inaccessible in long "split"
info files
. a bug where it was not possible to follow a cross-reference
that was split across more than one line has been fixed
. do not fall back to a man page if following a cross-reference in an
info file failed
. if looking for a file failed, do not convert the name of a file to
lower-case and look for it again
* texinfo.tex
. some faulty definitions for Unicode characters have been changed or
removed
. fix indentation in table of contents for entries that are split
across multiple lines
* texi2dvi
. a bug that broke the processing of LaTeX files that did not
use BibTeX has been fixed
* texi2any
. output the encoding declaration of a HTML file earlier so it
will always occur within first 1024 bytes of file
. `INLINE_INSERTCOPYING' removed as a customization variable
6.4 (23 June 2017)
* texi2any:
. for HTML output, place section names before the manual in page
titles, instead of after them, so it is easier to distinguish pages
if titles are truncated
. starting points for ordered lists beginning with 0 or a letter of
the alphabet are output as attributes on the <ol> tag, as was
case for Texinfo 4.13 and earlier
. a bit faster
. some discrepancies in paragraph formatting between Perl extension
modules and interpreted Perl modules have been fixed
. `MACRO_BODY_IGNORES_LEADING_SPACE' customization variable removed,
and `indent_menu_descriptions' is no longer a possible value for
`TREE_TRANSFORMATIONS' (as these features did not work as
documented)
* info:
. the `up-line' and `down-line' commands now are like the other
scrolling commands and are no longer confined to a single node
(depending on the value of `scroll-behaviour')
. supplying the --all option with --index-search displays a list
of matching index entries
. the style variables like `link-style' can now be set while info
is running
. display bug fixed where color could be turned off prematurely
. several other bugs fixed
. better portability in test suite
. do not fall back to showing the dir node if a manual isn't found
. Do not attempt any kind of conversion of CR LF line endings,
except on MS-DOS/Windows, when it is done unconditionally. (This
replaces a more complicated approach, where this conversion would
take place if there was a problem finding a node in a file.) The
main effect of this change is that Info files with CR LF line
endings, which would have been produced on MS-DOS/Windows with old
versions of makeinfo, are only supported on such operating systems.
. a few of the key bindings under --vi-keys have been changed for
consistency or to match the documentation
* texinfo.tex
. a DVI file with a single empty page can be output again, which
restores the behavior from Texinfo 6.0 and earlier
* Distribution
. autoconf 2.69, automake 1.15, gettext 0.19.8
6.3 (10 September 2016)
* Language:
. The commands `@setcontentsaftertitlepage' and
`@setshortcontentsaftertitlepage' have been removed.
. @-commands are no longer supported within `@errormsg'.
* texinfo.tex:
. For a couple of characters (opening and closing braces), use glyphs
from the standard TeX math fonts instead of using EC fonts which are
less likely to be installed.
. Use of user-defined macros in the text of an index entry is more
reliable when the text contains Texinfo @-commands.
. @synindex and @syncodeindex have been fixed (broken in the last
release).
. Support added for native UTF-8 support with XeTeX and LuaTeX.
. Support of PDF output with XeTeX improved.
. You can use a new file doc/texinfo-ja.tex for Texinfo documents in
Japanese. doc/short-sample-ja.tex is a sample document. New
support file doc/txi-ja.tex for Japanese.
* texi2any:
. Fix handling of compiler options when building Perl extension modules.
* texi2dvi:
. Can now process files whose absolute paths contain space characters,
as long a relative path to the file is given. Better support of
files with unusual characters in their names.
. No longer exits prematurely in some circumstances (due to the script
running under "set -e").
. Bug fixed which made the `--command' and `--tidy' options
incompatible.
* info:
. Handling of "invalid" value in infokey file fixed.
6.2 (withdrawn)
Changelog:
6.1 (06 February 2016)
* Language:
. You can now omit the @menu from nodes with other nodes below them in
the document structure. If you use "@validatemenus off" near the
start of a Texinfo file, makeinfo will, where needed, create a menu
for nodes lacking one given explicitly.
. An @setfilename line is no longer required at the start of a
Texinfo file. (Be aware, though, that some other tools may require
it, for example Automake.)
. For processing with TeX, a comma is automatically provided following
a cross-reference command (such as @xref) when needed to separate
the page number from following text, so you don't need to add one
yourself. See the `Parts of a Cross Reference' node in the manual
for details. Behavior when followed by punctuation, as always
recommended previously, is unchanged.
* texi2any:
. Some Perl modules have been rewritten in C to increase speed.
If Perl extensions can be created, they are used by default;
otherwise the pure Perl implementations are still used.
Disable at build time with "configure --disable-perl-xs". The
environment variable TEXINFO_XS controls how they are used by
texi2any.
. Quotation marks are left out for node names and index entries in
Info output where they would have been produced by commands such
as @file or @option.
. New customization variable INFO_SPECIAL_CHARS_QUOTE to allow use of
a quoting mechanism for problematic constructs in Info output, for
example node names containing colons or commas.
. Commands like @heading are affected by @lowersections and @raisesections
again, as was the case before Texinfo 5.0.
* texinfo.tex:
. You may explicitly specify a sort key for an index entry by preceding
the text of the entry with the @sortas commmand with the sort key
desired as a braced argument. Additionally, you may choose to
ignore all occurences of the characters \, @, <, and - using new
flags you can specify with @set: `txiindexbackslashignore',
`txiindexatsignignore', `txiindexlessthanignore', and
`txiindexhyphenignore' respectively.
. Changes to macro handling to more closely match makeinfo. Ends of
lines are preserved in an argument to a macro taking a single
argument.
. By default, suppress heading line on a page with a chapter on it, to
avoid having the chapter title repeated.
. Use a larger font for arguments in a @deffn line and similar.
. The default indices (cp, ky and so on) now don't get a file opened
for them unless they are actually used. This reduces the number of
files that a run of TeX produces, and also allows for a greater
number of user-defined indices, because you will not bump into TeX's
limit of 16 open files at once so soon.
. For initials in indices that are non-alphanumeric characters (for
example, backslash, or braces), avoid use of a typewriter font.
This gives a more consistent appearance.
. Have a stronger preference for breaking a column in an index before
a letter heading.
. Formatting improvements in tables of contents and indices. Entries
can extend slightly into the margin instead of being broken across
two lines, and text is split more evenly across lines. Reduce
chance of an orphaned index entry appearing at the top of a column.
. Support character encodings beyond ASCII for XeTeX and LuaTeX by
reading file input byte-by-byte.
* texi2dvi:
. Support for determining the output files using the `-recorder'
option to TeX, to help to support more TeX engines.
* info:
. New user variables `link-style', `active-link-style', and
`match-style' enable customization of how cross-references and search
matches are highlighted.
. By default only the node pointers are displayed at the top of a node.
Customize this with the `nodeline' variable.
. New command M-x tree-search to search all subnodes of a node.
. Now tries to find referenced manuals in the same directory as the
current file first, before looking in search path. Customize this
with new variable `follow-strategy'.
. The `mouse' variable is now off by default, in order not to
interfere with the selection of text in a terminal emulator window.
. `q' closes a window instead of quitting altogether if there's more
than one, for example if a help window is open.
. Several bug fixes, including:
. one causing the wrong position in a node to be shown when
following an "anchor" cross-reference
. one causing a test failure in the t/c-u-m-x-scroll-forward.sh
test on some platforms
. Internal changes to reduce memory use and increase speed of
searches, relative to last release
. The meaning of the `key-time' variable has changed when its value
is 0. This value meant to wait forever in the last release, but now
it means that the next byte must be available immediately.
* Documentation:
. The `info.info' file (and `info.texi' source) is no longer
distributed with Texinfo. Now this manual is only in Emacs.
* Distribution:
. automake-1.15, gettext-0.19.6.
Issues found with existing distfiles:
distfiles/eclipse-sourceBuild-srcIncluded-3.0.1.zip
distfiles/fortran-utils-1.1.tar.gz
distfiles/ivykis-0.39.tar.gz
distfiles/enum-1.11.tar.gz
distfiles/pvs-3.2-libraries.tgz
distfiles/pvs-3.2-linux.tgz
distfiles/pvs-3.2-solaris.tgz
distfiles/pvs-3.2-system.tgz
No changes made to these distinfo files.
Otherwise, existing SHA1 digests verified and found to be the same on
the machine holding the existing distfiles (morden). All existing
SHA1 digests retained for now as an audit trail.
Changelog:
6.0 (26 June 2015)
* Language:
. new commands @sub and @sup, for textual subscripts and superscripts.
. new command @U to insert a Unicode character by code point.
* texinfo.tex:
. @url/@uref output in PDF now the same as in DVI, showing the url
even if the second argument is given, not just as a link target.
TeX option \urefurlonlylinktrue gives previous behavior, of invisible urls.
PDF-only \linkcolor and \urlcolor specify colors (default black).
* texi2any:
. customization variable TOP_NODE_UP_URL now replaces all (dir) references;
recommended setting for GNU packages is /manual/.
. new customization variable INDEX_SPECIAL_CHARS_WARNING to complain
when index entries contain a colon.
. Docbook output no longer uses <lineannotation> for @r.
. -D'var val' on the command line works as intended again.
. --plaintext output can be split.
. a bit faster.
* info:
. invoking as `info foo bar' looks for bar as an index entry in manual
foo, if not found as a top-level menu item.
. invoking info with an absolute or explicitly relative file name
(./foo.info, /tmp/foo.info, etc.) just visits that file.
. separate `infokey' program has been removed - the .infokey file is
now read directly by Info.
. new option --init-file allows overriding ~/.infokey.
. new variable `highlight-searches' allows highlighting results from a
search
. support for mouse scrollwheel, controlled by `mouse' variable.
. new variable `key_time' to control how long to wait for byte
sequences sent by special keys.
. new variable `hide-note-references' alters appearance of displayed nodes
. new variable `infopath-no-defaults' allows omitting the compile-time
Info directory from the Info search path.
. support input of multibyte characters for searches in a UTF-8 locale.
. if reading an Info file that is known to be in a different character
encoding to that of the user's environment, convert its contents
when displayed and substitute missing characters
. new command M-x info-version.
. the M-x kill-node command has been removed.
. test suite at build time.
* texindex:
. completely new implementation as a literate program using Texinfo
and (portable) awk (called TexiWeb Jr.), thanks to Arnold Robbins.
(Requires gawk 4.0+ if .twjr source is modified.)
. the -o (--output) is not supported, unless we hear of someone using it.
. duplicated sort keys with different display texts result in one
merged index entry, using the first display text.
. better sorting and parsing in unusual cases; most notably, { and }
characters can appear as initials.
* install-info:
. handle compressed input file names containing spaces.
. exit successfully if --remove is given and the dir file does not exist.
. new option --defsection, to be used instead of "Miscellaneous" when
a section is not present in the Info file.
* texi2dvi:
. look for the environment variable THUMBPDF_CMD instead of THUMBPDF,
since thumbpdf itself has used THUMBPDF for options since 2000.
. remove --recode and --recode-from options, since they haven't
worked as intended for years, so evidently no one needs them.
* Distribution:
. new translation ca (catalan).
. automake-1.15, gettext-0.19.4.
Do it for all packages that
* mention perl, or
* have a directory name starting with p5-*, or
* depend on a package starting with p5-
like last time, for 5.18, where this didn't lead to complaints.
Let me know if you have any this time.
as indicated in pkg/48075, wherein pdksh doesn't support double-parens
if not containing an arithmetic expression of a particular form.
Older bash and ast-ksh apparently also had problems with this.
5.2 (26 September 2013)
* Language:
. new commands @inlinefmtifelse, @inlineifset, @inlineifclear, for
more brace-delimited alternatives to the conditional environments.
* texi2any:
. warns about node names, menu items, and cross-references (but not
index entries) containing problematic characters; can be disabled
with -c INFO_SPECIAL_CHARS_WARNING=0.
* info:
. new option -x (--debug) for debugging output; -x -1 to get everything.
. new option -v (--variable) assigns a value to an Info variable,
with the usual syntax, -v VARIABLE=VALUE.
. new option -a (--all) instructs Info to display all documents
matching the command line arguments, not just the first. In
conjunction with the -w option, it shows full names of all Info
files matching the command line arguments; with -o, it outputs all
matching files.
. new variable search-skip-screen controls the starting position for
repeated search commands ({ and }). When set to On, repeated
searches skip the lines displayed on the screen, i.e.,
forward searches (}) start at the beginning of the next page, and
backward searches ({) start at the end of the previous page.
. new command display-file-info (bound to = by default, C-g in vi mode)
shows full file name of the node being displayed and position in it.
* texi2dvi:
. support for biblatex+biber.
* Distribution: automake-1.14, gettext-0.18.3.1.
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.
in my testing. Adding dependency on bash in gtexinfo causes a circular
dependency on hosts without makeinfo since bash requires makeinfo and
makeinfo gets replaced with gtexinfo.
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.
