xref: /netbsd-src/external/gpl2/texinfo/dist/NEWS (revision 29619d2afe564e54d657b83e5a3ae89584f83720)
1*29619d2aSchristosId: NEWS,v 1.103 2004/12/24 16:43:58 karl Exp
2*29619d2aSchristosThis file records noteworthy changes, very tersely.
3*29619d2aSchristosSee the manual for detailed information.
4*29619d2aSchristos
5*29619d2aSchristos  Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
6*29619d2aSchristos  2001, 2002, 2003, 2004 Free Software Foundation, Inc.
7*29619d2aSchristos
8*29619d2aSchristos  Copying and distribution of this file, with or without modification,
9*29619d2aSchristos  are permitted in any medium without royalty provided the copyright
10*29619d2aSchristos  notice and this notice are preserved.
11*29619d2aSchristos
12*29619d2aSchristos
13*29619d2aSchristos*** IMPORTANT NEWS FOR ALL AUTHORS OF TEXINFO MANUALS ***
14*29619d2aSchristos
15*29619d2aSchristosAs of version 4.2, Texinfo has a new command @copying to define the
16*29619d2aSchristoscopyright and copying permissions for a manual.  It's important to
17*29619d2aSchristosswitch to using it as soon as possible (as in your next release),
18*29619d2aSchristosbecause the historical method of doing copyright permissions using
19*29619d2aSchristos@ifinfo failed to output copyright information in the HTML (or XML)
20*29619d2aSchristosformats.  The manual has detailed explanations and examples.  For
21*29619d2aSchristosconvenience, here's a url to one of the relevant sections:
22*29619d2aSchristos  http://www.gnu.org/software/texinfo/manual/texinfo/html_node/Document-Permissions.html
23*29619d2aSchristos
24*29619d2aSchristos-------------------------------------------------------------------------------
25*29619d2aSchristos
26*29619d2aSchristos4.8 (31 December 2004)
27*29619d2aSchristos* Language:
28*29619d2aSchristos  . new command @euro for the Euro currency symbol, and
29*29619d2aSchristos    @documentencoding has some support for ISO-8859-15.
30*29619d2aSchristos  . new command @abbr for general abbreviations.
31*29619d2aSchristos  . new command @slanted to typeset text in a slanted font,
32*29619d2aSchristos    and @sansserif to typeset in a sans serif font.
33*29619d2aSchristos* makeinfo:
34*29619d2aSchristos  . An empty first argument to cross-reference commands, such as @xref,
35*29619d2aSchristos    causes an error.  This change was made in 4.1, but not mentioned in NEWS.
36*29619d2aSchristos  . HTML output:
37*29619d2aSchristos    - <a name="..."> constructs are added for the old-style
38*29619d2aSchristos      conversion of node names to HTML names, so that external references
39*29619d2aSchristos      to them can continue to work.
40*29619d2aSchristos    - "g_t" prefixed to targets for node names beginning with a
41*29619d2aSchristos      nonletter, for XHTML compatibility.
42*29619d2aSchristos  . Docbook output: recognize more image formats.
43*29619d2aSchristos* texi2dvi:
44*29619d2aSchristos  . new option --recode, to call recode for input character translation.
45*29619d2aSchristos* Distribution:
46*29619d2aSchristos  . new convenience script texi2pdf, equivalent to texi2dvi --pdf (from tetex).
47*29619d2aSchristos  . some cross-compiling support in configure && make.
48*29619d2aSchristos  . new configure option --disable-install-warnings, for TeX.
49*29619d2aSchristos    distributions which do have the files installed.
50*29619d2aSchristos  . automake 1.9.4.
51*29619d2aSchristos
52*29619d2aSchristos
53*29619d2aSchristos4.7 (9 April 2004)
54*29619d2aSchristos* Language:
55*29619d2aSchristos  . new commands @float, @caption, @shortcaption, @listoffloats for
56*29619d2aSchristos    initial implementation of floating material (figures, tables, etc).
57*29619d2aSchristos    Ironically, they do not yet actually float anywhere.
58*29619d2aSchristos  . new commands @docbook, @ifdocbook, @ifnotdocbook for conditional Docbook.
59*29619d2aSchristos  . new commands @ordf{} and @ordm{} for Spanish feminine/masculine ordinals.
60*29619d2aSchristos  . new commands @deftypecv[x] for class variables in typed OO languages.
61*29619d2aSchristos  . new command @registeredsymbol for the r-in-a-circle symbol.
62*29619d2aSchristos  . new command @headitem to make a heading row in @multitable.
63*29619d2aSchristos  . new command @LaTeX{} for the LaTeX logo.
64*29619d2aSchristos  . new command @comma{} to avoid comma-parsing problems.
65*29619d2aSchristos  . @url is now a synonym for @uref; new command @indicateurl has the
66*29619d2aSchristos    old meaning of just displaying a url as text.
67*29619d2aSchristos  . @quotation now accepts an optional argument for labelling the text
68*29619d2aSchristos      as a `Note', `Tip', etc.
69*29619d2aSchristos  . @defun (et al.) heading lines can now be continued with a lone @.
70*29619d2aSchristos  . @acronym accepts an optional argument for the meaning of the acronym.
71*29619d2aSchristos* makeinfo:
72*29619d2aSchristos  . New environment variable TEXINFO_OUTPUT_FORMAT determines the output
73*29619d2aSchristos    format at runtime, if no options are specified.
74*29619d2aSchristos  . New option --plaintext, equivalent to --no-headers with Info output.
75*29619d2aSchristos  . All outputs:
76*29619d2aSchristos    - sections are numbered by default.
77*29619d2aSchristos  . Info output:
78*29619d2aSchristos    - punctuation is inserted after @pxref and @ref, if needed to make
79*29619d2aSchristos      cross-references valid.
80*29619d2aSchristos    - line numbers included in index menus, so Info readers can go to
81*29619d2aSchristos      the exact line of an entry, not just a node.  Also in plaintext output.
82*29619d2aSchristos    - ^@^H[index^@^H] cookie included in index menus, so Info readers
83*29619d2aSchristos      can handle the ] etc. commands better.
84*29619d2aSchristos  . HTML output:
85*29619d2aSchristos    - new algorithm for cross-references to other manuals, for maximum
86*29619d2aSchristos      portability and stability.
87*29619d2aSchristos    - include node name in <title> with split output.
88*29619d2aSchristos    - @multicolumn fractions become percentages.
89*29619d2aSchristos    - entities used for bullets, quotes, dashes, and others.
90*29619d2aSchristos    - index entries are links to the exact locations.
91*29619d2aSchristos    - <h4> and <h5> used for @sub and @subsubsections again.
92*29619d2aSchristos    - accented dotless i supported.
93*29619d2aSchristos  . XML output: many new tags and structure to preserve more source features.
94*29619d2aSchristos  . Docbook output:
95*29619d2aSchristos    - upgraded DTD to Docbook XML 4.2, no longer using Docbook SGML.
96*29619d2aSchristos    - improved translation in general, for instance:
97*29619d2aSchristos    - line annotations and marked quotations.
98*29619d2aSchristos* texi2dvi:
99*29619d2aSchristos  . if available, use etex (pdfetex if --pdf) by default.
100*29619d2aSchristos  . if the input file includes thumbpdf.sty (for LaTeX), then run thumbpdf.
101*29619d2aSchristos  . more output if --debug.
102*29619d2aSchristos* texinfo.tex:
103*29619d2aSchristos  . @defun names are now printed in typewriter (instead of bold), and
104*29619d2aSchristos    within the arguments, @var text is printed in slanted typewriter.
105*29619d2aSchristos  . @tex code is executed inside a TeX group, so that any changes must
106*29619d2aSchristos    be prefixed with \global (or the equivalent) to be effective.  (This
107*29619d2aSchristos    change was actually made years ago, but never made it into the NEWS.)
108*29619d2aSchristos* info:
109*29619d2aSchristos  . new option --where (aka --location, -w) to report where an Info file
110*29619d2aSchristos    would be found, instead of reading it.
111*29619d2aSchristos  . by default, output ANSI terminal escape sequences as-is; new option
112*29619d2aSchristos    --no-raw-escapes overrides this.
113*29619d2aSchristos  . use the newly-generated index line numbers.
114*29619d2aSchristos* Distribution:
115*29619d2aSchristos  . new script gendocs.sh (not installed), for use by GNU maintainers in
116*29619d2aSchristos    getting their manuals on the GNU web site.  Documented in
117*29619d2aSchristos    maintain.texi (http://www.gnu.org/prep/maintain/).
118*29619d2aSchristos  . Most code uses ANSI C prototypes, to some extent.
119*29619d2aSchristos  . New translation: nb.
120*29619d2aSchristos  . automake 1.8.3, autoconf 2.59, gettext 0.14.1.
121*29619d2aSchristos
122*29619d2aSchristos
123*29619d2aSchristos4.6 (10 June 2003)
124*29619d2aSchristos* Language:
125*29619d2aSchristos  . new command @/ specifies an allowable breakpoint within a line.
126*29619d2aSchristos  . new command @dofirstparagraphindent to control whether the first
127*29619d2aSchristos    paragraph following a section heading is indented.  Default is to
128*29619d2aSchristos    omit this indentation, unlike the output up to now.
129*29619d2aSchristos  . new command @indent for explicitly indenting a paragraph.
130*29619d2aSchristos  . makeinfo writes a new construct for @image in Info output, so that
131*29619d2aSchristos    graphical Info browsers (such as Emacs Info under X) can display an
132*29619d2aSchristos    actual image.  (Standalone Info ignores this, since it runs in a tty.)
133*29619d2aSchristos* makeinfo:
134*29619d2aSchristos  . Common:
135*29619d2aSchristos    - search for image files in the include file search path.
136*29619d2aSchristos    - warns if @value is used on an undefined variable.
137*29619d2aSchristos  . Info output:
138*29619d2aSchristos    - default --split-size now 300,000 bytes, up from 50,000.
139*29619d2aSchristos    - with --enable-encoding and a given @documentencoding,
140*29619d2aSchristos      output a Local Variables section specifying that encoding, for use
141*29619d2aSchristos      with Emacs.
142*29619d2aSchristos  . HTML output:
143*29619d2aSchristos    - uses <h3> at the smallest.
144*29619d2aSchristos    - a few css <style> definitions are included to better
145*29619d2aSchristos      implement @format, @display, @small..., etc.
146*29619d2aSchristos    - new option --css-include=FILE includes FILE in the <style>.
147*29619d2aSchristos    - @cartouche now outputs a <table> with a border.
148*29619d2aSchristos* texinfo.tex:
149*29619d2aSchristos  . new Polish translation txi-pl.tex.
150*29619d2aSchristos* texi2dvi:
151*29619d2aSchristos  . --command=CMD replaces --texinfo=CMD; it inserts CMD at the first
152*29619d2aSchristos    line of LaTeX files now, or after the @setfilename for Texinfo files.
153*29619d2aSchristos* info:
154*29619d2aSchristos  . RET now goes to the nearest xref (rather like Emacs Info),
155*29619d2aSchristos    instead of the next xref starting on the current line.
156*29619d2aSchristos* Distribution:
157*29619d2aSchristos  . new Romanian (ro) translation.
158*29619d2aSchristos  . variables now declared const where appropriate.
159*29619d2aSchristos  . gettext 0.12.1, automake 1.7.5.
160*29619d2aSchristos
161*29619d2aSchristos
162*29619d2aSchristos4.5 (4 February 2003)
163*29619d2aSchristos* info:
164*29619d2aSchristos  . a bug in 4.4 prevented compressed info files from being found.
165*29619d2aSchristos* Distribution:
166*29619d2aSchristos  . detect sys/ptem.h on Solaris.
167*29619d2aSchristos
168*29619d2aSchristos
169*29619d2aSchristos4.4 (31 January 2003)
170*29619d2aSchristos* Language:
171*29619d2aSchristos  . The ' (ASCII apostrophe/right quote) character is finally allowed in
172*29619d2aSchristos    node and anchor names.  Thus, after installing this texinfo.tex,
173*29619d2aSchristos    existing .aux files will cause errors!  Remove them and rerun TeX to
174*29619d2aSchristos    generate good ones.
175*29619d2aSchristos  . @value constructs are now expanded in the filename arguments to
176*29619d2aSchristos    @include and @verbatiminclude.
177*29619d2aSchristos* makeinfo:
178*29619d2aSchristos  . @macro names may no longer include ^ or _, for the sake of math mode.
179*29619d2aSchristos  . bug fix: @copying text is now reflected in tag table positions;
180*29619d2aSchristos    before, nodes may not have been found with a long-enough @copying.
181*29619d2aSchristos  . bug fix: html @verb arg is quoted properly, and does not imply
182*29619d2aSchristos    a paragraph break.
183*29619d2aSchristos* texinfo.tex:
184*29619d2aSchristos  . @smallexample and the like now output in a smaller font (9pt) in all
185*29619d2aSchristos    paper formats, not just @smallbook and @afourpaper.
186*29619d2aSchristos  . new translation txi-tr.tex.
187*29619d2aSchristos  . bug fix: <>| and other characters do not disappear when they are
188*29619d2aSchristos    first on a line in @verbatim.
189*29619d2aSchristos* install-info:
190*29619d2aSchristos  . bug fix: don't translate the `* Menu' info keyword.
191*29619d2aSchristos* info:
192*29619d2aSchristos  . CTRL-H is treated like DEL in incremental search.
193*29619d2aSchristos  . arrow keys once again work in isearch contexts under Solaris.
194*29619d2aSchristos* infokey:
195*29619d2aSchristos  . use .info key bindings before defaults.
196*29619d2aSchristos  . allow prefix keys to be disabled.
197*29619d2aSchristos* Distribution:
198*29619d2aSchristos  . update to GNU FDL 1.2 (http://www.gnu.org/licenses/fdl.html).
199*29619d2aSchristos  . getopt and other common library files updated from gnulib
200*29619d2aSchristos    (http://savannah.gnu.org/projects/gnulib/).
201*29619d2aSchristos  . autoconf 2.57, automake 1.7.2.
202*29619d2aSchristos
203*29619d2aSchristos
204*29619d2aSchristos4.3 (14 November 2002)
205*29619d2aSchristos* Language:
206*29619d2aSchristos  . new command @tie{} to do a real tie (unbreakable interword space).
207*29619d2aSchristos* makeinfo:
208*29619d2aSchristos  . html output for @defun and friends now has font changes.
209*29619d2aSchristos  . html output has some class attributes.
210*29619d2aSchristos  . xml and docbook output improved in many details.
211*29619d2aSchristos* texinfo.tex:
212*29619d2aSchristos  . new Italian translations, txi-it.tex.
213*29619d2aSchristos  . pdf bookmarks for unnumbered sections work.
214*29619d2aSchristos  . type name for @defun and friends no longer extends into margin.
215*29619d2aSchristos* info:
216*29619d2aSchristos  . automatic-footnotes now off by default, for emacs compatibility.
217*29619d2aSchristos  . crash when MALLOC_CHECK_=2 fixed.
218*29619d2aSchristos* install-info:
219*29619d2aSchristos  . new option --infodir synonym for --info-dir, for compatibility with
220*29619d2aSchristos    the Debian install-info.
221*29619d2aSchristos  . support for bzip2-compressed files.
222*29619d2aSchristos* texindex:
223*29619d2aSchristos  . omit initial if the entire index is under one character.
224*29619d2aSchristos* Distribution:
225*29619d2aSchristos . development sources now available under CVS, see
226*29619d2aSchristos   http://savannah.gnu.org/projects/texinfo/
227*29619d2aSchristos . Turkish message translation.
228*29619d2aSchristos . gettext 0.11.5, autoconf 2.54, automake 1.7.1.
229*29619d2aSchristos
230*29619d2aSchristos
231*29619d2aSchristos4.2 (1 April 2002)
232*29619d2aSchristos* Language:
233*29619d2aSchristos  . new command @copying to define copying permissions.  See above.
234*29619d2aSchristos  . new conditionals @ifplaintext, @ifnotplaintext for the plain text
235*29619d2aSchristos    (--no-headers) output format.
236*29619d2aSchristos  . new command @\ to produce literal \ inside @math, since \ by itself
237*29619d2aSchristos    no longer works.
238*29619d2aSchristos* makeinfo:
239*29619d2aSchristos  . emit accesskey attributes for keyboard shortcuts to menu items.
240*29619d2aSchristos  . @{even,every,odd}{footing,header} are ignored by makeinfo now, so
241*29619d2aSchristos    they no longer need to be enclosed in @iftex.
242*29619d2aSchristos* texinfo.tex:
243*29619d2aSchristos  . bug fix for pdf-format table of contents.
244*29619d2aSchristos* info:
245*29619d2aSchristos  . bug fixes for -R (--raw-escapes).
246*29619d2aSchristos  . --help shows short option names.
247*29619d2aSchristos* Distribution:
248*29619d2aSchristos  . the doc.c, funs.h, and key.c files in info/ are no longer generated
249*29619d2aSchristos    at make time, to appease Automake's make distcheck.
250*29619d2aSchristos  . gettext 0.11.1, autoconf 2.53, automake 1.6 (with install-info kludge).
251*29619d2aSchristos
252*29619d2aSchristos
253*29619d2aSchristos4.1 (4 March 2002)
254*29619d2aSchristos* Language:
255*29619d2aSchristos  . new commands @verbatim and @verb for printing verbatim inserts.
256*29619d2aSchristos  . new command @verbatiminclude for verbatim include of files.
257*29619d2aSchristos  . new environment @documentdescription for defining the HTML description.
258*29619d2aSchristos  . new command @afivepaper for the A5 paper size.
259*29619d2aSchristos* makeinfo:
260*29619d2aSchristos  . supports xml and docbook output.
261*29619d2aSchristos  . supports HTML splitting by node, which is now the default.
262*29619d2aSchristos  . new option --split-size to control maximum size of split info files.
263*29619d2aSchristos  . new option --enable-encoding to enable
264*29619d2aSchristos* info:
265*29619d2aSchristos  . user-specified key bindings supported.
266*29619d2aSchristos  . ANSI escape sequences (as produced by groff) removed from man output
267*29619d2aSchristos    by default; use --raw-escapes to let them through if your terminal
268*29619d2aSchristos    supports them.
269*29619d2aSchristos  . RET terminates incremental search normally.
270*29619d2aSchristos* texinfo.tex:
271*29619d2aSchristos  . @math implies @tex, so all the usual plain TeX math is supported.
272*29619d2aSchristos  . smaller fonts for @smallexample, in all page sizes.
273*29619d2aSchristos  . improvements in the PDF support.
274*29619d2aSchristos* texi2dvi:
275*29619d2aSchristos  . new option -o to explicitly specify output filename.
276*29619d2aSchristos* Distribution:
277*29619d2aSchristos  . switch to GNU Free Documentation License (http://www.gnu.org/copyleft/).
278*29619d2aSchristos  . update to GNU gettext 0.11, autoconf 2.52, and automake 1.5.
279*29619d2aSchristos  . Danish, Swedish, and Hebrew message translations.
280*29619d2aSchristos
281*29619d2aSchristos
282*29619d2aSchristos4.0 (28 September 1999)
283*29619d2aSchristos* Language:
284*29619d2aSchristos  . New command @anchor for cross references to arbitrary points.
285*29619d2aSchristos  . New commands @documentlanguage sets the main document language,
286*29619d2aSchristos    and @documentencoding sets the document input encoding (although not
287*29619d2aSchristos    much is done yet with either).
288*29619d2aSchristos  . New command @pagesizes allows limited control of text area for typesetting.
289*29619d2aSchristos  . New command @acronym for abbreviations in all caps, such as `NASA'.
290*29619d2aSchristos  . New command @alias for simple command aliases.
291*29619d2aSchristos  . New command @definfoenclose for better control of info output.
292*29619d2aSchristos  . New commands @deftypeivar for typed instance variables of a class
293*29619d2aSchristos    and @deftypeop for typed operations of a class.
294*29619d2aSchristos  . New command @novalidate suppresses cross-reference checking and (in
295*29619d2aSchristos    TeX) auxiliary file creation.
296*29619d2aSchristos  . New commands @setcontentsaftertitlepage and
297*29619d2aSchristos    @setshortcontentsaftertitlepage to force printing the table of
298*29619d2aSchristos    contents after @end titlepage.  Also, @contents and @shortcontents
299*29619d2aSchristos    themselves can now appear at the beginning of the document as
300*29619d2aSchristos    well as the end.
301*29619d2aSchristos  . New markup commands: @env (for environment variables), @command (for
302*29619d2aSchristos    command names), @option (for command-line options).
303*29619d2aSchristos  . New commands @smallformat and @smalldisplay, a la @smallexample.
304*29619d2aSchristos  . New command @exampleindent to set indentation of example-like
305*29619d2aSchristos    environments a la @paragraphindent.
306*29619d2aSchristos  . @uref takes an optional third argument of text to show instead of
307*29619d2aSchristos    (rather than in addition to) the url for info and dvi output.
308*29619d2aSchristos  . @footnote works in an @item for a @table.
309*29619d2aSchristos* texinfo.tex:
310*29619d2aSchristos  . latest version always at ftp://ftp.gnu.org/gnu/texinfo/texinfo.tex
311*29619d2aSchristos    (and mirrors).
312*29619d2aSchristos  . implements @macro.
313*29619d2aSchristos  . implements @paragraphindent (except asis).
314*29619d2aSchristos  . @emph and @i use true italic type (cmti) instead of slanted (cmsl).
315*29619d2aSchristos  . implements pdf output when run with pdftex.
316*29619d2aSchristos  . better support for internationalization via txi-??.tex files.
317*29619d2aSchristos  . footnotes now set in a smaller point size.
318*29619d2aSchristos* makeinfo:
319*29619d2aSchristos  . supports HTML output with the --html option.
320*29619d2aSchristos  . implication of --html: @top nodes should be wrapped in @ifnottex
321*29619d2aSchristos    rather than @ifinfo.  @ifinfo conditionals are not expanded with --html.
322*29619d2aSchristos  . new option --number-sections to output chapter/section numbers.
323*29619d2aSchristos  . dashes and quotes are not treated specially in node names.
324*29619d2aSchristos  . new option --commands-in-node-names to allow @-commands in node names.
325*29619d2aSchristos    (Not implemented in TeX, and most likely never will be.)
326*29619d2aSchristos  . @emph output uses _underscores_.
327*29619d2aSchristos  . @image looks for .png files before .jpg.
328*29619d2aSchristos  . only output `Making ... file' line when verbose.
329*29619d2aSchristos  . allow -v as synonym for --verbose.
330*29619d2aSchristos  . new command line options to specify which conditionals to process
331*29619d2aSchristos    (but --iftex is not fully implemented).
332*29619d2aSchristos  . warns if @var contains any of ,[]().
333*29619d2aSchristos  . @quote-arg implicitly done for all one-argument macros, so commas in
334*29619d2aSchristos    the argument text are allowed.
335*29619d2aSchristos  . \\ required in macro body to get single \, no other `escapes' defined.
336*29619d2aSchristos* info:
337*29619d2aSchristos  . ISO Latin 1 characters are displayed and input as-is by default.
338*29619d2aSchristos  . new option --vi-keys to enable vi-like and less-like key bindings.
339*29619d2aSchristos  . new command S does case-sensitive searching.
340*29619d2aSchristos  . new commands C-x n and C-x N repeat last search, respectively, in the
341*29619d2aSchristos    same and in reverse direction, without prompting for the string.  These
342*29619d2aSchristos    commands are bound to n and N under --vi-keys, like in Less.
343*29619d2aSchristos  . new command G menu1 menu2 ... searches for menu items from (dir),
344*29619d2aSchristos    as allowed on the command line.
345*29619d2aSchristos  . new command O (capital o, not zero) goes directly to the node that
346*29619d2aSchristos    describes command-line options.
347*29619d2aSchristos  . new command-line option --show-options causes the node which
348*29619d2aSchristos    describes command-line options to be the first node displayed.
349*29619d2aSchristos  . M-prior and M-DEL do new command info-scroll-other-window-backward.
350*29619d2aSchristos  . / searches like s does.
351*29619d2aSchristos  . If the search string includes upper-case letters, in both incremental
352*29619d2aSchristos    and non-incremental search, the search is case-sensitive.
353*29619d2aSchristos  . S searches case-sensitively even if the search string is all
354*29619d2aSchristos    lower-case.
355*29619d2aSchristos  . - makes the argument negative (so e.g. `- /' searches backward).
356*29619d2aSchristos  . l restores point in the window returned to.
357*29619d2aSchristos  . SPC/DEL do not move outside the current document.
358*29619d2aSchristos  . foo.info is found before foo.
359*29619d2aSchristos  . `info foo --index-search=bar' now searches for bar in foo's index.
360*29619d2aSchristos  . support for files compressed with bzip2.
361*29619d2aSchristos* install-info:
362*29619d2aSchristos  . handles gzipped dir files.
363*29619d2aSchristos  . sort entries into alphabetical order.
364*29619d2aSchristos  . install direntries only in preceding dircategory, not in all.
365*29619d2aSchristos  . --delete does not require the info file to exist.
366*29619d2aSchristos  . --delete can handle XEmacs-style dir entries.
367*29619d2aSchristos* texi2dvi:
368*29619d2aSchristos  . bug fixed: now uses only the @iftex and @tex parts of the source.
369*29619d2aSchristos  . process LaTeX source as well as Texinfo source.
370*29619d2aSchristos  . output PDF (using pdftex) with new option --pdf.
371*29619d2aSchristos  . handles --OPTION=ARG style of command line arguments.
372*29619d2aSchristos  . new option --batch for progress reports but no interaction.
373*29619d2aSchristos  . new option --clean to remove all auxiliary files.
374*29619d2aSchristos  . new option --quiet for silence (unless there are errors).
375*29619d2aSchristos  . new option -I for specifying directories for @include to search.
376*29619d2aSchristos  . handles LaTeX files (running BibTeX etc.).
377*29619d2aSchristos* Fixes to util/gen-dir-node and util/fix-info-dir (formerly util/update-info).
378*29619d2aSchristos* Distribution:
379*29619d2aSchristos  . Man pages included.
380*29619d2aSchristos  . Czech and Norwegian message translations.
381*29619d2aSchristos  . Various translations for texinfo.tex fixed words included.
382*29619d2aSchristos  . DJGPP support.
383*29619d2aSchristos
384*29619d2aSchristos
385*29619d2aSchristos3.12 (3 March 1998)
386*29619d2aSchristos* Elisp files removed, since they are only usefully distributed with Emacs.
387*29619d2aSchristos* Restore inclusion of compile-time $(infodir) to INFOPATH.
388*29619d2aSchristos* install-info creates a proper dir file.
389*29619d2aSchristos* Various portability fixes.
390*29619d2aSchristos
391*29619d2aSchristos
392*29619d2aSchristos3.11 (31 July 1997)
393*29619d2aSchristos* New commands:
394*29619d2aSchristos  - @uref to make a reference to a url; @url now only indicates such.
395*29619d2aSchristos  - @image to include graphics (epsf for TeX).
396*29619d2aSchristos  - @deftypemethod and @deftypemethodx to document methods in strongly
397*29619d2aSchristos    typed object-oriented languages, such as C++.
398*29619d2aSchristos  - @html for raw HTML.
399*29619d2aSchristos  - @ifnothtml @ifnotinfo @ifnottex for more precise conditionals.
400*29619d2aSchristos  - @kbdinputstyle to control when @kbd uses the slanted typewriter font.
401*29619d2aSchristos  - @email takes second optional argument.
402*29619d2aSchristos* texinfo.tex reads texinfo.cnf (if present) for site-wide TeX
403*29619d2aSchristos  configuration; for example, A4 paper sizes.
404*29619d2aSchristos* info:
405*29619d2aSchristos  - arrow keys supported.
406*29619d2aSchristos  - trailing : in INFOPATH appends default path.
407*29619d2aSchristos  - new option --index-search for online help support.
408*29619d2aSchristos* makeinfo:
409*29619d2aSchristos  - output files removed if errors unless (new option) --force.
410*29619d2aSchristos  - new option -P to prepend to search path.
411*29619d2aSchristos  - macro expansion file can be standard output.
412*29619d2aSchristos* install-info creates a new dir file if necessary.
413*29619d2aSchristos* update-info script to create a dir file from all info files.
414*29619d2aSchristos* Elisp: texnfo-tex.el and detexinfo.el removed from the distribution;
415*29619d2aSchristos  - texnfo-tex features are now part of standard TeX & Texinfo packages;
416*29619d2aSchristos  - makeinfo --no-headers does a better job than detexinfo.el.
417*29619d2aSchristos* Documentation:
418*29619d2aSchristos  - Updates, revisions, corrections in the manual.
419*29619d2aSchristos  - makeinfo.texi removed, as it was a copy of what was in texinfo.texi.
420*29619d2aSchristos* gettext support in sources, French and German translations included.
421*29619d2aSchristos* info man page removed; use the Texinfo manual.
422*29619d2aSchristos* Automake used, other portability fixes.
423*29619d2aSchristos
424*29619d2aSchristos3.10 (nonexistent)
425*29619d2aSchristos
426*29619d2aSchristos
427*29619d2aSchristos3.9 (4 October 1996)
428*29619d2aSchristos* makeinfo:
429*29619d2aSchristos  - Give a suppressible (with --no-validate) error for references
430*29619d2aSchristos    outside of any node.
431*29619d2aSchristos  - Keep track of multitable output correctly for split files; this
432*29619d2aSchristos    caused nodes after the first multitable to be ``undefined''.
433*29619d2aSchristos* install-info:
434*29619d2aSchristos  - Rename --infodir option to --info-dir.
435*29619d2aSchristos  - More robust error checking to avoid various crashes.
436*29619d2aSchristos* configure: Include replacements for memcpy and memmove functions in
437*29619d2aSchristos  the distribution, in case they are missing.
438*29619d2aSchristos
439*29619d2aSchristos
440*29619d2aSchristos3.8 (30 September 1996)
441*29619d2aSchristos* Define and/or document new and/or previously existing commands:
442*29619d2aSchristos  Accents: @" @' @, @" @= @^ @` @~ @H @d @dotaccent @dotless @ringaccent
443*29619d2aSchristos    @tieaccent @u @ubaraccent @v
444*29619d2aSchristos  Special characters: @AA @AE @L @O @OE @aa @ae @exclamdown @l @o @oe
445*29619d2aSchristos    @pounds @questiondown @ss
446*29619d2aSchristos  Special punctuation: @! @? @enddots
447*29619d2aSchristos  dir file maintenance: @dircategory @direntry; also new program, install-info
448*29619d2aSchristos  HTML support: @email @url @ifhtml...@end ifhtml
449*29619d2aSchristos  Macros: @macro @unmacro
450*29619d2aSchristos  Tables: @multitable @tab
451*29619d2aSchristos  Hyphenation: @- @hyphenation
452*29619d2aSchristos  Spacing: @  @<TAB> @<NEWLINE>
453*29619d2aSchristos  Sectioning:
454*29619d2aSchristos    @headings singleafter/doubleafter (change heading style after current page)
455*29619d2aSchristos    @centerchap
456*29619d2aSchristos    @setchapterstyle
457*29619d2aSchristos  Other:
458*29619d2aSchristos    @shorttitlepage (simple title pages)
459*29619d2aSchristos    @detailmenu...@end detailmenu (help makeinfo parse master menus)
460*29619d2aSchristos* Makeinfo prefers an input file named `foo.texinfo' or `foo.texi' or
461*29619d2aSchristos  `foo.txinfo' to just `foo' (the latter most likely being an executable).
462*29619d2aSchristos* Makeinfo implements @. @! @? correctly, as end-of-sentence punctuation.
463*29619d2aSchristos* @key marks its argument with a lozenge in TeX and <...> in Info.
464*29619d2aSchristos* TeX output has substantially decreased interline spacing and other
465*29619d2aSchristos  formatting changes.
466*29619d2aSchristos* Remove these obsolete and never-documented commands:
467*29619d2aSchristos    @infotop
468*29619d2aSchristos    @infoappendix @infoappendixsec @infoappendixsubsec @infoappendixsubsubsec
469*29619d2aSchristos    @infochapter @infosection @infosubsection @infosubsubsection
470*29619d2aSchristos    @infounnumbered @infounnumberedsec @infounnumberedsubsec
471*29619d2aSchristos      @infounnumberedsubsubsec
472*29619d2aSchristos    @input
473*29619d2aSchristos    @smallbreak @medbreak
474*29619d2aSchristos    @overfullrule
475*29619d2aSchristos    @br
476*29619d2aSchristos* Deprecate these obsolete commands, to be removed in the next release:
477*29619d2aSchristos    @ctrl
478*29619d2aSchristos    @infoinclude
479*29619d2aSchristos    @iappendix @iappendixsection @iappendixsec @iappendixsubsec
480*29619d2aSchristos      @iappendixsubsubsec
481*29619d2aSchristos    @ichapter @isection @isubsection @isubsubsection
482*29619d2aSchristos    @iunnumbered @iunnumberedsec @iunnumberedsubsec @iunnumberedsubsubsec
483*29619d2aSchristos    @setchapterstyle
484*29619d2aSchristos    @titlespec
485*29619d2aSchristos
486*29619d2aSchristos
487*29619d2aSchristos3.7 (24 December 1995)
488*29619d2aSchristos* Have --version print texinfo release number as well as the individual
489*29619d2aSchristos  program version.
490*29619d2aSchristos* Better man page cleaning.
491*29619d2aSchristos* Update Elisp files from current Emacs release.
492*29619d2aSchristos
493*29619d2aSchristos
494*29619d2aSchristos3.6 (21 June 1995)
495*29619d2aSchristos* Unmatched brace error reporting improved.
496*29619d2aSchristos* Missing comment terminator prevented compilation.
497*29619d2aSchristos
498*29619d2aSchristos
499*29619d2aSchristos3.5 (20 June 1995)
500*29619d2aSchristos* Autoconf update.
501*29619d2aSchristos* Support for parallel makes.
502*29619d2aSchristos* make install does not install Elisp files.
503*29619d2aSchristos
504*29619d2aSchristos
505*29619d2aSchristos3.4 (19 June 1995)
506*29619d2aSchristos* Handle @ifhtml in Elisp.
507*29619d2aSchristos* Update FSF address.
508*29619d2aSchristos
509*29619d2aSchristos
510*29619d2aSchristos3.3 (15 June 1995)
511*29619d2aSchristos* Portability changes.
512*29619d2aSchristos* Compile Elisp files.
513*29619d2aSchristos* Don't distribute .info* files.
514*29619d2aSchristos
515*29619d2aSchristos
516*29619d2aSchristos3.2 (9 June 1995)
517*29619d2aSchristos* Standalone Info can read Unix man pages.
518*29619d2aSchristos* New commands: @! @? @^ @" @enddots.
519*29619d2aSchristos* makeinfo -E does macro expansion (and nothing else).
520*29619d2aSchristos
521*29619d2aSchristos
522*29619d2aSchristos3.1 (23 May 1993)
523*29619d2aSchristosJust bug fixes, see ChangeLog for full details.
524*29619d2aSchristos
525*29619d2aSchristos
526*29619d2aSchristos3.0: first release of Texinfo version 2, with many new commands.
527*29619d2aSchristos
528*29619d2aSchristos
529*29619d2aSchristos
530*29619d2aSchristosHere is the separate NEWS for old releases of Info:
531*29619d2aSchristos
532*29619d2aSchristosVersion 2.11,     Sat Apr  1 09:15:21 1995
533*29619d2aSchristos
534*29619d2aSchristosChanges since 2.7 beta:
535*29619d2aSchristos
536*29619d2aSchristosAlthough the basic code remains the same, there are numerous nits
537*29619d2aSchristosfixed, including some display bugs, and a memory leak.  Some changes
538*29619d2aSchristosthat have taken place with larger impact include the way in which the
539*29619d2aSchristos(dir) node is built; I have added in support for "localdir"
540*29619d2aSchristosdirectories among other things.  Info files may be stored in
541*29619d2aSchristoscompressed formats, and in their own subdirectories; menu items which
542*29619d2aSchristosdo not explicitly name the node to which they are attached have the
543*29619d2aSchristosmenu item name looked up as an Info file if it is not found within the
544*29619d2aSchristoscurrent document.  This means that the menu item:
545*29619d2aSchristos
546*29619d2aSchristos* Info::		The Info documentation reader.
547*29619d2aSchristos
548*29619d2aSchristosin (dir) refers to the info node "(info)Top".
549*29619d2aSchristos
550*29619d2aSchristosPlease see the ChangeLog and documentation for details on other
551*29619d2aSchristoschanges.
552*29619d2aSchristos
553*29619d2aSchristosVersion 2.7 beta, Wed Dec 30 02:02:38 1992
554*29619d2aSchristosVersion 2.6 beta, Tue Dec 22 03:58:07 1992
555*29619d2aSchristosVersion 2.5 beta, Tue Dec  8 14:50:35 1992
556*29619d2aSchristosVersion 2.4 beta, Sat Nov 28 14:34:02 1992
557*29619d2aSchristosVersion 2.3 beta, Fri Nov 27 01:04:13 1992
558*29619d2aSchristosVersion 2.2 beta, Tue Nov 24 09:36:08 1992
559*29619d2aSchristosVersion 2.1 beta, Tue Nov 17 23:29:36 1992
560*29619d2aSchristos
561*29619d2aSchristosChanges since 2.5 beta:
562*29619d2aSchristos
563*29619d2aSchristosNote that versions 2.6 and 2.7 Beta were only released to a select group.
564*29619d2aSchristos
565*29619d2aSchristos* "info-" removed from the front of M-x commands.
566*29619d2aSchristos
567*29619d2aSchristos* Automatic footnote display.  When you enter a node which contains
568*29619d2aSchristos  footnotes, and the variable "automatic-footnotes" is "On", Info pops
569*29619d2aSchristos  up a window containing the footnotes.  Likewise, when you leave that
570*29619d2aSchristos  node, the window containing the footnotes goes away.
571*29619d2aSchristos
572*29619d2aSchristos* Cleaner built in documentation, and documentation functions.
573*29619d2aSchristos
574*29619d2aSchristos  Use:
575*29619d2aSchristos    o `M-x describe-variable' to read a variable's documenation
576*29619d2aSchristos    o `M-x describe-key' to find out what a particular keystroke does.
577*29619d2aSchristos    o `M-x describe-function' to read a function's documentation.
578*29619d2aSchristos    o `M-x where-is' to find out what keys invoke a particular function.
579*29619d2aSchristos
580*29619d2aSchristos* Info can "tile" the displayed windows (via "M-x tile-windows").  If
581*29619d2aSchristos  the variable "automatic-tiling" is "On", then splitting a window or
582*29619d2aSchristos  deleting a window causes the remaining windows to be retiled.
583*29619d2aSchristos
584*29619d2aSchristos* You can save every keystroke you type in a "dribble file" by using the
585*29619d2aSchristos  `--dribble FILENAME' option.  You can initially read keystrokes from an
586*29619d2aSchristos  alternate input stream with `--restore FILENAME', or by redirecting
587*29619d2aSchristos  input on the command line `info < old-dribble'.
588*29619d2aSchristos
589*29619d2aSchristos* New behaviour of menu items.  If the label is the same as the
590*29619d2aSchristos  target node name, and the node couldn't be found in the current file,
591*29619d2aSchristos  treat the label as a file name.  For example, a menu entry in "DIR"
592*29619d2aSchristos  might contain:
593*29619d2aSchristos
594*29619d2aSchristos    * Emacs::		Cool text-editor.
595*29619d2aSchristos
596*29619d2aSchristos  Info would not find the node "(dir)Emacs", so just plain "(emacs)"
597*29619d2aSchristos  would be tried.
598*29619d2aSchristos
599*29619d2aSchristos* New variable "ISO-Latin" allows you to use European machines with
600*29619d2aSchristos  8-bit character sets.
601*29619d2aSchristos
602*29619d2aSchristos* Cleanups in echo area reading, and redisplay.  Cleanups in handling the
603*29619d2aSchristos  window which shows possible completions.
604*29619d2aSchristos
605*29619d2aSchristos* Info can now read files that have been compressed.  An array in filesys.c
606*29619d2aSchristos  maps extensions to programs that can decompress stdin, and write the results
607*29619d2aSchristos  to stdout.  Currently, ".Z"/uncompress, ".z"/gunzip, and ".Y"/unyabba are
608*29619d2aSchristos  supported.  The modeline for a compressed file shows "zz" in it.
609*29619d2aSchristos
610*29619d2aSchristos* There is a new variable "gc-compressed-files" which, if non-zero, says
611*29619d2aSchristos  it is okay to reclaim the file buffer space allocated to a file which
612*29619d2aSchristos  was compressed, if, and only if, that file's contents do not appear in
613*29619d2aSchristos  any history node.
614*29619d2aSchristos
615*29619d2aSchristos* New file `nodemenu.c' implements a few functions for manipulating
616*29619d2aSchristos  previously visited nodes.  `C-x C-b' (list-visited-nodes) produces a
617*29619d2aSchristos  menu of the nodes that could be reached by info-history-node in some
618*29619d2aSchristos  window.  `C-x b' (select-visited-node) is similar, but reads one of
619*29619d2aSchristos  the node names with completion.
620*29619d2aSchristos
621*29619d2aSchristos* Keystroke `M-r' (move_to_screen_line) allows the user to place the cursor at
622*29619d2aSchristos  the start of a specific screen line.  Without a numeric argument, place the
623*29619d2aSchristos  cursor on the center line; with an arg, place the cursor on that line.
624*29619d2aSchristos
625*29619d2aSchristos* Interruptible display implemented.  Basic display speedups and hacks.
626*29619d2aSchristos* The message "*** Tags Out of Date ***" now means what it says.
627*29619d2aSchristos* Index searching with `,' (info-index-next) has been improved.
628*29619d2aSchristos* When scrolling with C-v, C-M-v, or M-v, only "Page Only" scrolling
629*29619d2aSchristos  will happen.
630*29619d2aSchristos
631*29619d2aSchristos* Continous scrolling (along with `]' (info-global-next) and `['
632*29619d2aSchristos  (info-global-prev) works better.  `]' and `[' accept numeric
633*29619d2aSchristos  arguments, moving that many nodes in that case.
634*29619d2aSchristos
635*29619d2aSchristos* `C-x w' (info-toggle-wrap) controls how lines wider than the width
636*29619d2aSchristos  of the screen are displayed.  If a line is too long, a `$' is
637*29619d2aSchristos  displayed in the rightmost column of the window.
638*29619d2aSchristos
639*29619d2aSchristos* There are some new variables for controlling the behaviour of Info
640*29619d2aSchristos  interactively.  The current list of variables is as follows:
641*29619d2aSchristos
642*29619d2aSchristos  Variable Name      Default Value  Description
643*29619d2aSchristos  -------------      -------------  -----------
644*29619d2aSchristos  `automatic-footnotes' On	    When "On", footnotes appear and
645*29619d2aSchristos				    disappear automatically.
646*29619d2aSchristos
647*29619d2aSchristos  `automatic-tiling'    Off	    When "On", creating of deleting a
648*29619d2aSchristos				    window resizes other windows.
649*29619d2aSchristos
650*29619d2aSchristos  `visible-bell'        Off	    If non-zero, try to use a visible bell.
651*29619d2aSchristos
652*29619d2aSchristos  `errors-ring-bell'    On	    If non-zero, errors cause a ring.
653*29619d2aSchristos
654*29619d2aSchristos  `show-index-match'    On	    If non-zero, the portion of the string
655*29619d2aSchristos				    matched is highlighted by changing its
656*29619d2aSchristos				    case.
657*29619d2aSchristos
658*29619d2aSchristos  `scroll-behaviour'    Continuous  One of "Continuous", "Next Only", or
659*29619d2aSchristos				    "Page Only".  "Page Only" prevents you from
660*29619d2aSchristos				    scrolling past the bottom or top of a node.
661*29619d2aSchristos				    "Next Only" causes the Next or Prev node to
662*29619d2aSchristos				    be selected when you scroll past the bottom
663*29619d2aSchristos				    or top of a node.  "Continous" moves
664*29619d2aSchristos				    linearly through the files hierchichal
665*29619d2aSchristos				    structure.
666*29619d2aSchristos
667*29619d2aSchristos  `scroll-step'	        0	    Controls how scrolling is done for you when
668*29619d2aSchristos				    the cursor moves out of the current window.
669*29619d2aSchristos				    Non-zero means it is the number of lines
670*29619d2aSchristos				    you would like the screen to shift.  A
671*29619d2aSchristos				    value of 0 means to center the line
672*29619d2aSchristos				    containing the cursor in the window.
673*29619d2aSchristos
674*29619d2aSchristos  `gc-compressed-files' Off	    If non-zero means it is okay to reclaim the
675*29619d2aSchristos				    file buffer space allocated to a file which
676*29619d2aSchristos				    was compressed, if, and only if, that
677*29619d2aSchristos				    file's contents do not appear in the node
678*29619d2aSchristos				    list of any window.
679*29619d2aSchristos
680*29619d2aSchristos  `ISO-Latin'	        Off	    Non-zero means that you are using an ISO
681*29619d2aSchristos				    Latin character set.  By default, standard
682*29619d2aSchristos				    ASCII characters are assumed.
683*29619d2aSchristos________________________________________
684*29619d2aSchristosThis release of Info is version 2.5 beta.
685*29619d2aSchristos
686*29619d2aSchristosChanges since 2.4 beta:
687*29619d2aSchristos
688*29619d2aSchristos* Index (i) and (,) commands fully implemented.
689*29619d2aSchristos* "configure" script now shipped with Info.
690*29619d2aSchristos* New function "set-variable" allows users to set various variables.
691*29619d2aSchristos* User-settable behaviour on end or beginning of node scrolling.  This
692*29619d2aSchristos  supercedes the SPC and DEL changes in 2.3 beta.
693*29619d2aSchristos
694*29619d2aSchristos________________________________________
695*29619d2aSchristosThis release of Info is version 2.4 beta.
696*29619d2aSchristos
697*29619d2aSchristosChanges since 2.3 beta:
698*29619d2aSchristos
699*29619d2aSchristos* info-last-node now means move to the last node of this info file.
700*29619d2aSchristos* info-history-node means move backwards through this window's node history.
701*29619d2aSchristos* info-first-node moves to the first node in the Info file.  This node is
702*29619d2aSchristos  not necessarily "Top"!
703*29619d2aSchristos* SPC and DEL can select the Next or Prev node after printing an informative
704*29619d2aSchristos  message when pressed at the end/beg of a node.
705*29619d2aSchristos
706*29619d2aSchristos----------------------------------------
707*29619d2aSchristosThis release of Info is version 2.3 beta.
708*29619d2aSchristos
709*29619d2aSchristosChanges since 2.2 beta:
710*29619d2aSchristos
711*29619d2aSchristos* M-x command lines if NAMED_COMMANDS is #defined.  Variable in Makefile.
712*29619d2aSchristos* Screen height changes made quite robust.
713*29619d2aSchristos* Interactive function "set-screen-height" implements user height changes.
714*29619d2aSchristos* Scrolling on some terminals is faster now.
715*29619d2aSchristos* C-l with numeric arguement is fixed.
716*29619d2aSchristos
717*29619d2aSchristos----------------------------------------
718*29619d2aSchristosThis release of Info is version 2.2 beta.
719*29619d2aSchristos
720*29619d2aSchristosChanges since 2.0:
721*29619d2aSchristos
722*29619d2aSchristos* C-g can now interrupt multi-file searches.
723*29619d2aSchristos* Incremental search is fully implemented.
724*29619d2aSchristos* Loading large tag tables is much faster now.
725*29619d2aSchristos* makedoc.c replaces shell script, speeding incremental builds.
726*29619d2aSchristos* Scrolling in redisplay is implemented.
727*29619d2aSchristos* Recursive uses of the echo area made more robust.
728*29619d2aSchristos* Garbage collection of unreferenced nodes.
729