1146515Sru$Id: NEWS,v 1.103 2004/12/24 16:43:58 karl Exp $
2146515SruThis file records noteworthy changes, very tersely.
3146515SruSee the manual for detailed information.
493139Sru
5146515Sru  Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000,
6146515Sru  2001, 2002, 2003, 2004 Free Software Foundation, Inc.
793139Sru
8114472Sru  Copying and distribution of this file, with or without modification,
9114472Sru  are permitted in any medium without royalty provided the copyright
10114472Sru  notice and this notice are preserved.
1121495Sjmacd
12100513Sru
13100513Sru*** IMPORTANT NEWS FOR ALL AUTHORS OF TEXINFO MANUALS ***
14100513Sru
15100513SruAs of version 4.2, Texinfo has a new command @copying to define the
16100513Srucopyright and copying permissions for a manual.  It's important to
17100513Sruswitch to using it as soon as possible (as in your next release),
18100513Srubecause the historical method of doing copyright permissions using
19100513Sru@ifinfo failed to output copyright information in the HTML (or XML)
20100513Sruformats.  The manual has detailed explanations and examples.  For
21100513Sruconvenience, here's a url to one of the relevant sections:
22146515Sru  http://www.gnu.org/software/texinfo/manual/texinfo/html_node/Document-Permissions.html
23100513Sru
24114472Sru-------------------------------------------------------------------------------
25146515Sru
26146515Sru4.8 (31 December 2004)
27146515Sru* Language:
28146515Sru  . new command @euro for the Euro currency symbol, and
29146515Sru    @documentencoding has some support for ISO-8859-15.
30146515Sru  . new command @abbr for general abbreviations.
31146515Sru  . new command @slanted to typeset text in a slanted font,
32146515Sru    and @sansserif to typeset in a sans serif font.
33146515Sru* makeinfo:
34146515Sru  . An empty first argument to cross-reference commands, such as @xref,
35146515Sru    causes an error.  This change was made in 4.1, but not mentioned in NEWS.
36146515Sru  . HTML output:
37146515Sru    - <a name="..."> constructs are added for the old-style
38146515Sru      conversion of node names to HTML names, so that external references
39146515Sru      to them can continue to work.
40146515Sru    - "g_t" prefixed to targets for node names beginning with a
41146515Sru      nonletter, for XHTML compatibility.
42146515Sru  . Docbook output: recognize more image formats.
43146515Sru* texi2dvi:
44146515Sru  . new option --recode, to call recode for input character translation.
45146515Sru* Distribution:
46146515Sru  . new convenience script texi2pdf, equivalent to texi2dvi --pdf (from tetex).
47146515Sru  . some cross-compiling support in configure && make.
48146515Sru  . new configure option --disable-install-warnings, for TeX.
49146515Sru    distributions which do have the files installed.
50146515Sru  . automake 1.9.4.
51100513Sru
52146515Sru
53146515Sru4.7 (9 April 2004)
54146515Sru* Language:
55146515Sru  . new commands @float, @caption, @shortcaption, @listoffloats for
56146515Sru    initial implementation of floating material (figures, tables, etc).
57146515Sru    Ironically, they do not yet actually float anywhere.
58146515Sru  . new commands @docbook, @ifdocbook, @ifnotdocbook for conditional Docbook.
59146515Sru  . new commands @ordf{} and @ordm{} for Spanish feminine/masculine ordinals.
60146515Sru  . new commands @deftypecv[x] for class variables in typed OO languages.
61146515Sru  . new command @registeredsymbol for the r-in-a-circle symbol.
62146515Sru  . new command @headitem to make a heading row in @multitable.
63146515Sru  . new command @LaTeX{} for the LaTeX logo.
64146515Sru  . new command @comma{} to avoid comma-parsing problems.
65146515Sru  . @url is now a synonym for @uref; new command @indicateurl has the
66146515Sru    old meaning of just displaying a url as text.
67146515Sru  . @quotation now accepts an optional argument for labelling the text
68146515Sru      as a `Note', `Tip', etc.
69146515Sru  . @defun (et al.) heading lines can now be continued with a lone @.
70146515Sru  . @acronym accepts an optional argument for the meaning of the acronym.
71146515Sru* makeinfo:
72146515Sru  . New environment variable TEXINFO_OUTPUT_FORMAT determines the output
73146515Sru    format at runtime, if no options are specified.
74146515Sru  . New option --plaintext, equivalent to --no-headers with Info output.
75146515Sru  . All outputs:
76146515Sru    - sections are numbered by default.
77146515Sru  . Info output:
78146515Sru    - punctuation is inserted after @pxref and @ref, if needed to make
79146515Sru      cross-references valid.
80146515Sru    - line numbers included in index menus, so Info readers can go to
81146515Sru      the exact line of an entry, not just a node.  Also in plaintext output.
82146515Sru    - ^@^H[index^@^H] cookie included in index menus, so Info readers
83146515Sru      can handle the ] etc. commands better.
84146515Sru  . HTML output:
85146515Sru    - new algorithm for cross-references to other manuals, for maximum
86146515Sru      portability and stability.
87146515Sru    - include node name in <title> with split output.
88146515Sru    - @multicolumn fractions become percentages.
89146515Sru    - entities used for bullets, quotes, dashes, and others.
90146515Sru    - index entries are links to the exact locations.
91146515Sru    - <h4> and <h5> used for @sub and @subsubsections again.
92146515Sru    - accented dotless i supported.
93146515Sru  . XML output: many new tags and structure to preserve more source features.
94146515Sru  . Docbook output:
95146515Sru    - upgraded DTD to Docbook XML 4.2, no longer using Docbook SGML.
96146515Sru    - improved translation in general, for instance:
97146515Sru    - line annotations and marked quotations.
98146515Sru* texi2dvi:
99146515Sru  . if available, use etex (pdfetex if --pdf) by default.
100146515Sru  . if the input file includes thumbpdf.sty (for LaTeX), then run thumbpdf.
101146515Sru  . more output if --debug.
102146515Sru* texinfo.tex:
103146515Sru  . @defun names are now printed in typewriter (instead of bold), and
104146515Sru    within the arguments, @var text is printed in slanted typewriter.
105146515Sru  . @tex code is executed inside a TeX group, so that any changes must
106146515Sru    be prefixed with \global (or the equivalent) to be effective.  (This
107146515Sru    change was actually made years ago, but never made it into the NEWS.)
108146515Sru* info:
109146515Sru  . new option --where (aka --location, -w) to report where an Info file
110146515Sru    would be found, instead of reading it.
111146515Sru  . by default, output ANSI terminal escape sequences as-is; new option
112146515Sru    --no-raw-escapes overrides this.
113146515Sru  . use the newly-generated index line numbers.
114146515Sru* Distribution:
115146515Sru  . new script gendocs.sh (not installed), for use by GNU maintainers in
116146515Sru    getting their manuals on the GNU web site.  Documented in
117146515Sru    maintain.texi (http://www.gnu.org/prep/maintain/).
118146515Sru  . Most code uses ANSI C prototypes, to some extent.
119146515Sru  . New translation: nb.
120146515Sru  . automake 1.8.3, autoconf 2.59, gettext 0.14.1.
121146515Sru
122146515Sru
123116525Sru4.6 (10 June 2003)
124116525Sru* Language:
125116525Sru  . new command @/ specifies an allowable breakpoint within a line.
126116525Sru  . new command @dofirstparagraphindent to control whether the first
127116525Sru    paragraph following a section heading is indented.  Default is to
128116525Sru    omit this indentation, unlike the output up to now.
129116525Sru  . new command @indent for explicitly indenting a paragraph.
130116525Sru  . makeinfo writes a new construct for @image in Info output, so that
131116525Sru    graphical Info browsers (such as Emacs Info under X) can display an
132116525Sru    actual image.  (Standalone Info ignores this, since it runs in a tty.)
133116525Sru* makeinfo:
134116525Sru  . Common:
135116525Sru    - search for image files in the include file search path.
136116525Sru    - warns if @value is used on an undefined variable.
137116525Sru  . Info output:
138116525Sru    - default --split-size now 300,000 bytes, up from 50,000.
139116525Sru    - with --enable-encoding and a given @documentencoding,
140116525Sru      output a Local Variables section specifying that encoding, for use
141116525Sru      with Emacs.
142116525Sru  . HTML output:
143116525Sru    - uses <h3> at the smallest.
144116525Sru    - a few css <style> definitions are included to better
145116525Sru      implement @format, @display, @small..., etc.
146116525Sru    - new option --css-include=FILE includes FILE in the <style>.
147116525Sru    - @cartouche now outputs a <table> with a border.
148116525Sru* texinfo.tex:
149116525Sru  . new Polish translation txi-pl.tex.
150116525Sru* texi2dvi:
151116525Sru  . --command=CMD replaces --texinfo=CMD; it inserts CMD at the first
152116525Sru    line of LaTeX files now, or after the @setfilename for Texinfo files.
153116525Sru* info:
154116525Sru  . RET now goes to the nearest xref (rather like Emacs Info),
155116525Sru    instead of the next xref starting on the current line.
156116525Sru* Distribution:
157116525Sru  . new Romanian (ro) translation.
158116525Sru  . variables now declared const where appropriate.
159116525Sru  . gettext 0.12.1, automake 1.7.5.
160116525Sru
161116525Sru
162114472Sru4.5 (4 February 2003)
163114472Sru* info:
164114472Sru  . a bug in 4.4 prevented compressed info files from being found.
165114472Sru* Distribution:
166114472Sru  . detect sys/ptem.h on Solaris.
167114472Sru
168100513Sru
169114472Sru4.4 (31 January 2003)
170114472Sru* Language:
171114472Sru  . The ' (ASCII apostrophe/right quote) character is finally allowed in
172114472Sru    node and anchor names.  Thus, after installing this texinfo.tex,
173114472Sru    existing .aux files will cause errors!  Remove them and rerun TeX to
174114472Sru    generate good ones.
175114472Sru  . @value constructs are now expanded in the filename arguments to
176114472Sru    @include and @verbatiminclude.
177114472Sru* makeinfo:
178116525Sru  . @macro names may no longer include ^ or _, for the sake of math mode.
179114472Sru  . bug fix: @copying text is now reflected in tag table positions;
180114472Sru    before, nodes may not have been found with a long-enough @copying.
181114472Sru  . bug fix: html @verb arg is quoted properly, and does not imply
182114472Sru    a paragraph break.
183114472Sru* texinfo.tex:
184114472Sru  . @smallexample and the like now output in a smaller font (9pt) in all
185114472Sru    paper formats, not just @smallbook and @afourpaper.
186114472Sru  . new translation txi-tr.tex.
187114472Sru  . bug fix: <>| and other characters do not disappear when they are
188114472Sru    first on a line in @verbatim.
189114472Sru* install-info:
190114472Sru  . bug fix: don't translate the `* Menu' info keyword.
191114472Sru* info:
192114472Sru  . CTRL-H is treated like DEL in incremental search.
193114472Sru  . arrow keys once again work in isearch contexts under Solaris.
194114472Sru* infokey:
195114472Sru  . use .info key bindings before defaults.
196114472Sru  . allow prefix keys to be disabled.
197114472Sru* Distribution:
198114472Sru  . update to GNU FDL 1.2 (http://www.gnu.org/licenses/fdl.html).
199114472Sru  . getopt and other common library files updated from gnulib
200114472Sru    (http://savannah.gnu.org/projects/gnulib/).
201114472Sru  . autoconf 2.57, automake 1.7.2.
202116525Sru
203114472Sru
204114472Sru4.3 (14 November 2002)
205114472Sru* Language:
206114472Sru  . new command @tie{} to do a real tie (unbreakable interword space).
207114472Sru* makeinfo:
208114472Sru  . html output for @defun and friends now has font changes.
209114472Sru  . html output has some class attributes.
210114472Sru  . xml and docbook output improved in many details.
211114472Sru* texinfo.tex:
212114472Sru  . new Italian translations, txi-it.tex.
213114472Sru  . pdf bookmarks for unnumbered sections work.
214114472Sru  . type name for @defun and friends no longer extends into margin.
215114472Sru* info:
216114472Sru  . automatic-footnotes now off by default, for emacs compatibility.
217114472Sru  . crash when MALLOC_CHECK_=2 fixed.
218114472Sru* install-info:
219114472Sru  . new option --infodir synonym for --info-dir, for compatibility with
220114472Sru    the Debian install-info.
221114472Sru  . support for bzip2-compressed files.
222114472Sru* texindex:
223114472Sru  . omit initial if the entire index is under one character.
224114472Sru* Distribution:
225114472Sru . development sources now available under CVS, see
226114472Sru   http://savannah.gnu.org/projects/texinfo/
227114472Sru . Turkish message translation.
228114472Sru . gettext 0.11.5, autoconf 2.54, automake 1.7.1.
229114472Sru
230114472Sru
231100513Sru4.2 (1 April 2002)
232100513Sru* Language:
233100513Sru  . new command @copying to define copying permissions.  See above.
234100513Sru  . new conditionals @ifplaintext, @ifnotplaintext for the plain text
235100513Sru    (--no-headers) output format.
236100513Sru  . new command @\ to produce literal \ inside @math, since \ by itself
237100513Sru    no longer works.
238100513Sru* makeinfo:
239100513Sru  . emit accesskey attributes for keyboard shortcuts to menu items.
240100513Sru  . @{even,every,odd}{footing,header} are ignored by makeinfo now, so
241100513Sru    they no longer need to be enclosed in @iftex.
242100513Sru* texinfo.tex:
243100513Sru  . bug fix for pdf-format table of contents.
244100513Sru* info:
245100513Sru  . bug fixes for -R (--raw-escapes).
246100513Sru  . --help shows short option names.
247100513Sru* Distribution:
248100513Sru  . the doc.c, funs.h, and key.c files in info/ are no longer generated
249100513Sru    at make time, to appease Automake's make distcheck.
250100513Sru  . gettext 0.11.1, autoconf 2.53, automake 1.6 (with install-info kludge).
251100513Sru
252100513Sru
25393139Sru4.1 (4 March 2002)
25493139Sru* Language:
25593139Sru  . new commands @verbatim and @verb for printing verbatim inserts.
25693139Sru  . new command @verbatiminclude for verbatim include of files.
25793139Sru  . new environment @documentdescription for defining the HTML description.
25893139Sru  . new command @afivepaper for the A5 paper size.
25993139Sru* makeinfo:
26093139Sru  . supports xml and docbook output.
26193139Sru  . supports HTML splitting by node, which is now the default.
26293139Sru  . new option --split-size to control maximum size of split info files.
263116525Sru  . new option --enable-encoding to enable
26493139Sru* info:
26593139Sru  . user-specified key bindings supported.
26693139Sru  . ANSI escape sequences (as produced by groff) removed from man output
26793139Sru    by default; use --raw-escapes to let them through if your terminal
26893139Sru    supports them.
269116525Sru  . RET terminates incremental search normally.
27093139Sru* texinfo.tex:
27193139Sru  . @math implies @tex, so all the usual plain TeX math is supported.
27293139Sru  . smaller fonts for @smallexample, in all page sizes.
27393139Sru  . improvements in the PDF support.
27493139Sru* texi2dvi:
27593139Sru  . new option -o to explicitly specify output filename.
27693139Sru* Distribution:
27793139Sru  . switch to GNU Free Documentation License (http://www.gnu.org/copyleft/).
27893139Sru  . update to GNU gettext 0.11, autoconf 2.52, and automake 1.5.
27993139Sru  . Danish, Swedish, and Hebrew message translations.
28093139Sru
281100513Sru
28256160Sru4.0 (28 September 1999)
28356160Sru* Language:
28456160Sru  . New command @anchor for cross references to arbitrary points.
28556160Sru  . New commands @documentlanguage sets the main document language,
28656160Sru    and @documentencoding sets the document input encoding (although not
28756160Sru    much is done yet with either).
28856160Sru  . New command @pagesizes allows limited control of text area for typesetting.
28956160Sru  . New command @acronym for abbreviations in all caps, such as `NASA'.
29056160Sru  . New command @alias for simple command aliases.
29156160Sru  . New command @definfoenclose for better control of info output.
29256160Sru  . New commands @deftypeivar for typed instance variables of a class
29356160Sru    and @deftypeop for typed operations of a class.
29456160Sru  . New command @novalidate suppresses cross-reference checking and (in
29556160Sru    TeX) auxiliary file creation.
29656160Sru  . New commands @setcontentsaftertitlepage and
29756160Sru    @setshortcontentsaftertitlepage to force printing the table of
29856160Sru    contents after @end titlepage.  Also, @contents and @shortcontents
29956160Sru    themselves can now appear at the beginning of the document as
30056160Sru    well as the end.
30156160Sru  . New markup commands: @env (for environment variables), @command (for
30256160Sru    command names), @option (for command-line options).
30356160Sru  . New commands @smallformat and @smalldisplay, a la @smallexample.
30456160Sru  . New command @exampleindent to set indentation of example-like
30556160Sru    environments a la @paragraphindent.
30656160Sru  . @uref takes an optional third argument of text to show instead of
30756160Sru    (rather than in addition to) the url for info and dvi output.
30856160Sru  . @footnote works in an @item for a @table.
30956160Sru* texinfo.tex:
310114472Sru  . latest version always at ftp://ftp.gnu.org/gnu/texinfo/texinfo.tex
311114472Sru    (and mirrors).
31256160Sru  . implements @macro.
31356160Sru  . implements @paragraphindent (except asis).
31456160Sru  . @emph and @i use true italic type (cmti) instead of slanted (cmsl).
31556160Sru  . implements pdf output when run with pdftex.
31656160Sru  . better support for internationalization via txi-??.tex files.
31793139Sru  . footnotes now set in a smaller point size.
31856160Sru* makeinfo:
31956160Sru  . supports HTML output with the --html option.
32056160Sru  . implication of --html: @top nodes should be wrapped in @ifnottex
32156160Sru    rather than @ifinfo.  @ifinfo conditionals are not expanded with --html.
32256160Sru  . new option --number-sections to output chapter/section numbers.
32356160Sru  . dashes and quotes are not treated specially in node names.
32456160Sru  . new option --commands-in-node-names to allow @-commands in node names.
32556160Sru    (Not implemented in TeX, and most likely never will be.)
32656160Sru  . @emph output uses _underscores_.
32756160Sru  . @image looks for .png files before .jpg.
32856160Sru  . only output `Making ... file' line when verbose.
32956160Sru  . allow -v as synonym for --verbose.
33056160Sru  . new command line options to specify which conditionals to process
33156160Sru    (but --iftex is not fully implemented).
33256160Sru  . warns if @var contains any of ,[]().
33356160Sru  . @quote-arg implicitly done for all one-argument macros, so commas in
33456160Sru    the argument text are allowed.
33556160Sru  . \\ required in macro body to get single \, no other `escapes' defined.
33656160Sru* info:
33756160Sru  . ISO Latin 1 characters are displayed and input as-is by default.
33856160Sru  . new option --vi-keys to enable vi-like and less-like key bindings.
33956160Sru  . new command S does case-sensitive searching.
34056160Sru  . new commands C-x n and C-x N repeat last search, respectively, in the
34156160Sru    same and in reverse direction, without prompting for the string.  These
34256160Sru    commands are bound to n and N under --vi-keys, like in Less.
34356160Sru  . new command G menu1 menu2 ... searches for menu items from (dir),
34456160Sru    as allowed on the command line.
34556160Sru  . new command O (capital o, not zero) goes directly to the node that
34656160Sru    describes command-line options.
34756160Sru  . new command-line option --show-options causes the node which
34856160Sru    describes command-line options to be the first node displayed.
34956160Sru  . M-prior and M-DEL do new command info-scroll-other-window-backward.
35056160Sru  . / searches like s does.
35156160Sru  . If the search string includes upper-case letters, in both incremental
35256160Sru    and non-incremental search, the search is case-sensitive.
35356160Sru  . S searches case-sensitively even if the search string is all
35456160Sru    lower-case.
35556160Sru  . - makes the argument negative (so e.g. `- /' searches backward).
35656160Sru  . l restores point in the window returned to.
35756160Sru  . SPC/DEL do not move outside the current document.
35856160Sru  . foo.info is found before foo.
35956160Sru  . `info foo --index-search=bar' now searches for bar in foo's index.
36056160Sru  . support for files compressed with bzip2.
36156160Sru* install-info:
36256160Sru  . handles gzipped dir files.
36356160Sru  . sort entries into alphabetical order.
36456160Sru  . install direntries only in preceding dircategory, not in all.
36556160Sru  . --delete does not require the info file to exist.
36656160Sru  . --delete can handle XEmacs-style dir entries.
36756160Sru* texi2dvi:
36856160Sru  . bug fixed: now uses only the @iftex and @tex parts of the source.
36956160Sru  . process LaTeX source as well as Texinfo source.
37056160Sru  . output PDF (using pdftex) with new option --pdf.
37156160Sru  . handles --OPTION=ARG style of command line arguments.
37256160Sru  . new option --batch for progress reports but no interaction.
37356160Sru  . new option --clean to remove all auxiliary files.
37456160Sru  . new option --quiet for silence (unless there are errors).
37556160Sru  . new option -I for specifying directories for @include to search.
37656160Sru  . handles LaTeX files (running BibTeX etc.).
37756160Sru* Fixes to util/gen-dir-node and util/fix-info-dir (formerly util/update-info).
37856160Sru* Distribution:
37956160Sru  . Man pages included.
38056160Sru  . Czech and Norwegian message translations.
38156160Sru  . Various translations for texinfo.tex fixed words included.
38256160Sru  . DJGPP support.
38356160Sru
38456160Sru
38542660Smarkm3.12 (3 March 1998)
38642660Smarkm* Elisp files removed, since they are only usefully distributed with Emacs.
38742660Smarkm* Restore inclusion of compile-time $(infodir) to INFOPATH.
38842660Smarkm* install-info creates a proper dir file.
38942660Smarkm* Various portability fixes.
39042660Smarkm
39156160Sru
39242660Smarkm3.11 (31 July 1997)
39342660Smarkm* New commands:
39442660Smarkm  - @uref to make a reference to a url; @url now only indicates such.
39542660Smarkm  - @image to include graphics (epsf for TeX).
39642660Smarkm  - @deftypemethod and @deftypemethodx to document methods in strongly
39742660Smarkm    typed object-oriented languages, such as C++.
39842660Smarkm  - @html for raw HTML.
39942660Smarkm  - @ifnothtml @ifnotinfo @ifnottex for more precise conditionals.
40042660Smarkm  - @kbdinputstyle to control when @kbd uses the slanted typewriter font.
40142660Smarkm  - @email takes second optional argument.
40242660Smarkm* texinfo.tex reads texinfo.cnf (if present) for site-wide TeX
40342660Smarkm  configuration; for example, A4 paper sizes.
40442660Smarkm* info:
40542660Smarkm  - arrow keys supported.
40642660Smarkm  - trailing : in INFOPATH appends default path.
40742660Smarkm  - new option --index-search for online help support.
40842660Smarkm* makeinfo:
40942660Smarkm  - output files removed if errors unless (new option) --force.
41042660Smarkm  - new option -P to prepend to search path.
41142660Smarkm  - macro expansion file can be standard output.
41242660Smarkm* install-info creates a new dir file if necessary.
41342660Smarkm* update-info script to create a dir file from all info files.
41442660Smarkm* Elisp: texnfo-tex.el and detexinfo.el removed from the distribution;
41542660Smarkm  - texnfo-tex features are now part of standard TeX & Texinfo packages;
41642660Smarkm  - makeinfo --no-headers does a better job than detexinfo.el.
41742660Smarkm* Documentation:
41842660Smarkm  - Updates, revisions, corrections in the manual.
41942660Smarkm  - makeinfo.texi removed, as it was a copy of what was in texinfo.texi.
42042660Smarkm* gettext support in sources, French and German translations included.
42142660Smarkm* info man page removed; use the Texinfo manual.
42242660Smarkm* Automake used, other portability fixes.
42342660Smarkm
42442660Smarkm3.10 (nonexistent)
42542660Smarkm
42656160Sru
42721495Sjmacd3.9 (4 October 1996)
42821495Sjmacd* makeinfo:
42921495Sjmacd  - Give a suppressible (with --no-validate) error for references
43021495Sjmacd    outside of any node.
43121495Sjmacd  - Keep track of multitable output correctly for split files; this
43221495Sjmacd    caused nodes after the first multitable to be ``undefined''.
43321495Sjmacd* install-info:
43421495Sjmacd  - Rename --infodir option to --info-dir.
43521495Sjmacd  - More robust error checking to avoid various crashes.
43621495Sjmacd* configure: Include replacements for memcpy and memmove functions in
43721495Sjmacd  the distribution, in case they are missing.
43821495Sjmacd
43956160Sru
44021495Sjmacd3.8 (30 September 1996)
44121495Sjmacd* Define and/or document new and/or previously existing commands:
44221495Sjmacd  Accents: @" @' @, @" @= @^ @` @~ @H @d @dotaccent @dotless @ringaccent
44321495Sjmacd    @tieaccent @u @ubaraccent @v
44421495Sjmacd  Special characters: @AA @AE @L @O @OE @aa @ae @exclamdown @l @o @oe
44521495Sjmacd    @pounds @questiondown @ss
44621495Sjmacd  Special punctuation: @! @? @enddots
44721495Sjmacd  dir file maintenance: @dircategory @direntry; also new program, install-info
44821495Sjmacd  HTML support: @email @url @ifhtml...@end ifhtml
44921495Sjmacd  Macros: @macro @unmacro
45021495Sjmacd  Tables: @multitable @tab
45121495Sjmacd  Hyphenation: @- @hyphenation
45221495Sjmacd  Spacing: @  @<TAB> @<NEWLINE>
45321495Sjmacd  Sectioning:
45421495Sjmacd    @headings singleafter/doubleafter (change heading style after current page)
45521495Sjmacd    @centerchap
45621495Sjmacd    @setchapterstyle
45721495Sjmacd  Other:
45821495Sjmacd    @shorttitlepage (simple title pages)
45921495Sjmacd    @detailmenu...@end detailmenu (help makeinfo parse master menus)
46021495Sjmacd* Makeinfo prefers an input file named `foo.texinfo' or `foo.texi' or
46121495Sjmacd  `foo.txinfo' to just `foo' (the latter most likely being an executable).
46221495Sjmacd* Makeinfo implements @. @! @? correctly, as end-of-sentence punctuation.
46321495Sjmacd* @key marks its argument with a lozenge in TeX and <...> in Info.
46421495Sjmacd* TeX output has substantially decreased interline spacing and other
46521495Sjmacd  formatting changes.
46621495Sjmacd* Remove these obsolete and never-documented commands:
46721495Sjmacd    @infotop
46821495Sjmacd    @infoappendix @infoappendixsec @infoappendixsubsec @infoappendixsubsubsec
46921495Sjmacd    @infochapter @infosection @infosubsection @infosubsubsection
47021495Sjmacd    @infounnumbered @infounnumberedsec @infounnumberedsubsec
47121495Sjmacd      @infounnumberedsubsubsec
47221495Sjmacd    @input
47321495Sjmacd    @smallbreak @medbreak
47421495Sjmacd    @overfullrule
47521495Sjmacd    @br
47621495Sjmacd* Deprecate these obsolete commands, to be removed in the next release:
47721495Sjmacd    @ctrl
47821495Sjmacd    @infoinclude
47921495Sjmacd    @iappendix @iappendixsection @iappendixsec @iappendixsubsec
48021495Sjmacd      @iappendixsubsubsec
48156160Sru    @ichapter @isection @isubsection @isubsubsection
48221495Sjmacd    @iunnumbered @iunnumberedsec @iunnumberedsubsec @iunnumberedsubsubsec
48321495Sjmacd    @setchapterstyle
48421495Sjmacd    @titlespec
48521495Sjmacd
48656160Sru
48721495Sjmacd3.7 (24 December 1995)
48821495Sjmacd* Have --version print texinfo release number as well as the individual
48921495Sjmacd  program version.
49021495Sjmacd* Better man page cleaning.
49121495Sjmacd* Update Elisp files from current Emacs release.
49221495Sjmacd
49356160Sru
49421495Sjmacd3.6 (21 June 1995)
49521495Sjmacd* Unmatched brace error reporting improved.
49621495Sjmacd* Missing comment terminator prevented compilation.
49721495Sjmacd
49856160Sru
49921495Sjmacd3.5 (20 June 1995)
50021495Sjmacd* Autoconf update.
50121495Sjmacd* Support for parallel makes.
50221495Sjmacd* make install does not install Elisp files.
50321495Sjmacd
50456160Sru
50521495Sjmacd3.4 (19 June 1995)
50621495Sjmacd* Handle @ifhtml in Elisp.
50721495Sjmacd* Update FSF address.
50821495Sjmacd
50956160Sru
51021495Sjmacd3.3 (15 June 1995)
51121495Sjmacd* Portability changes.
51221495Sjmacd* Compile Elisp files.
51321495Sjmacd* Don't distribute .info* files.
51421495Sjmacd
51556160Sru
51621495Sjmacd3.2 (9 June 1995)
51721495Sjmacd* Standalone Info can read Unix man pages.
51821495Sjmacd* New commands: @! @? @^ @" @enddots.
51921495Sjmacd* makeinfo -E does macro expansion (and nothing else).
52021495Sjmacd
52156160Sru
52221495Sjmacd3.1 (23 May 1993)
52356160SruJust bug fixes, see ChangeLog for full details.
52421495Sjmacd
52556160Sru
52656160Sru3.0: first release of Texinfo version 2, with many new commands.
52742660Smarkm
52842660Smarkm
52956160Sru
53042660SmarkmHere is the separate NEWS for old releases of Info:
53142660Smarkm
53242660SmarkmVersion 2.11,     Sat Apr  1 09:15:21 1995
53342660Smarkm
53442660SmarkmChanges since 2.7 beta:
53542660Smarkm
53642660SmarkmAlthough the basic code remains the same, there are numerous nits
53742660Smarkmfixed, including some display bugs, and a memory leak.  Some changes
53842660Smarkmthat have taken place with larger impact include the way in which the
53942660Smarkm(dir) node is built; I have added in support for "localdir"
54042660Smarkmdirectories among other things.  Info files may be stored in
54142660Smarkmcompressed formats, and in their own subdirectories; menu items which
54242660Smarkmdo not explicitly name the node to which they are attached have the
54342660Smarkmmenu item name looked up as an Info file if it is not found within the
54442660Smarkmcurrent document.  This means that the menu item:
54542660Smarkm
54642660Smarkm* Info::		The Info documentation reader.
54742660Smarkm
54842660Smarkmin (dir) refers to the info node "(info)Top".
54942660Smarkm
55042660SmarkmPlease see the ChangeLog and documentation for details on other
55142660Smarkmchanges.
55242660Smarkm
55342660SmarkmVersion 2.7 beta, Wed Dec 30 02:02:38 1992
55442660SmarkmVersion 2.6 beta, Tue Dec 22 03:58:07 1992
55542660SmarkmVersion 2.5 beta, Tue Dec  8 14:50:35 1992
55642660SmarkmVersion 2.4 beta, Sat Nov 28 14:34:02 1992
55742660SmarkmVersion 2.3 beta, Fri Nov 27 01:04:13 1992
55842660SmarkmVersion 2.2 beta, Tue Nov 24 09:36:08 1992
55942660SmarkmVersion 2.1 beta, Tue Nov 17 23:29:36 1992
56042660Smarkm
56142660SmarkmChanges since 2.5 beta:
56242660Smarkm
56342660SmarkmNote that versions 2.6 and 2.7 Beta were only released to a select group.
56442660Smarkm
56542660Smarkm* "info-" removed from the front of M-x commands.
56642660Smarkm
56742660Smarkm* Automatic footnote display.  When you enter a node which contains
56842660Smarkm  footnotes, and the variable "automatic-footnotes" is "On", Info pops
56942660Smarkm  up a window containing the footnotes.  Likewise, when you leave that
57042660Smarkm  node, the window containing the footnotes goes away.
57142660Smarkm
57242660Smarkm* Cleaner built in documentation, and documentation functions.
57342660Smarkm
57442660Smarkm  Use:
57542660Smarkm    o `M-x describe-variable' to read a variable's documenation
57642660Smarkm    o `M-x describe-key' to find out what a particular keystroke does.
57742660Smarkm    o `M-x describe-function' to read a function's documentation.
57842660Smarkm    o `M-x where-is' to find out what keys invoke a particular function.
57942660Smarkm
58042660Smarkm* Info can "tile" the displayed windows (via "M-x tile-windows").  If
58142660Smarkm  the variable "automatic-tiling" is "On", then splitting a window or
58242660Smarkm  deleting a window causes the remaining windows to be retiled.
58342660Smarkm
58442660Smarkm* You can save every keystroke you type in a "dribble file" by using the
58542660Smarkm  `--dribble FILENAME' option.  You can initially read keystrokes from an
58642660Smarkm  alternate input stream with `--restore FILENAME', or by redirecting
58742660Smarkm  input on the command line `info < old-dribble'.
58842660Smarkm
58942660Smarkm* New behaviour of menu items.  If the label is the same as the
59042660Smarkm  target node name, and the node couldn't be found in the current file,
59142660Smarkm  treat the label as a file name.  For example, a menu entry in "DIR"
59242660Smarkm  might contain:
59342660Smarkm
59442660Smarkm    * Emacs::		Cool text-editor.
59542660Smarkm
59642660Smarkm  Info would not find the node "(dir)Emacs", so just plain "(emacs)"
59742660Smarkm  would be tried.
59842660Smarkm
59942660Smarkm* New variable "ISO-Latin" allows you to use European machines with
60042660Smarkm  8-bit character sets.
60142660Smarkm
60242660Smarkm* Cleanups in echo area reading, and redisplay.  Cleanups in handling the
60342660Smarkm  window which shows possible completions.
60442660Smarkm
60542660Smarkm* Info can now read files that have been compressed.  An array in filesys.c
60642660Smarkm  maps extensions to programs that can decompress stdin, and write the results
60742660Smarkm  to stdout.  Currently, ".Z"/uncompress, ".z"/gunzip, and ".Y"/unyabba are
60842660Smarkm  supported.  The modeline for a compressed file shows "zz" in it.
60942660Smarkm
61042660Smarkm* There is a new variable "gc-compressed-files" which, if non-zero, says
61142660Smarkm  it is okay to reclaim the file buffer space allocated to a file which
61242660Smarkm  was compressed, if, and only if, that file's contents do not appear in
61342660Smarkm  any history node.
61442660Smarkm
61542660Smarkm* New file `nodemenu.c' implements a few functions for manipulating
61642660Smarkm  previously visited nodes.  `C-x C-b' (list-visited-nodes) produces a
61742660Smarkm  menu of the nodes that could be reached by info-history-node in some
61842660Smarkm  window.  `C-x b' (select-visited-node) is similar, but reads one of
61942660Smarkm  the node names with completion.
62042660Smarkm
62142660Smarkm* Keystroke `M-r' (move_to_screen_line) allows the user to place the cursor at
62242660Smarkm  the start of a specific screen line.  Without a numeric argument, place the
62342660Smarkm  cursor on the center line; with an arg, place the cursor on that line.
62442660Smarkm
62542660Smarkm* Interruptible display implemented.  Basic display speedups and hacks.
62642660Smarkm* The message "*** Tags Out of Date ***" now means what it says.
62742660Smarkm* Index searching with `,' (info-index-next) has been improved.
62842660Smarkm* When scrolling with C-v, C-M-v, or M-v, only "Page Only" scrolling
62942660Smarkm  will happen.
63042660Smarkm
63142660Smarkm* Continous scrolling (along with `]' (info-global-next) and `['
63242660Smarkm  (info-global-prev) works better.  `]' and `[' accept numeric
63342660Smarkm  arguments, moving that many nodes in that case.
63442660Smarkm
63542660Smarkm* `C-x w' (info-toggle-wrap) controls how lines wider than the width
63642660Smarkm  of the screen are displayed.  If a line is too long, a `$' is
63742660Smarkm  displayed in the rightmost column of the window.
63842660Smarkm
63942660Smarkm* There are some new variables for controlling the behaviour of Info
64042660Smarkm  interactively.  The current list of variables is as follows:
64142660Smarkm
64242660Smarkm  Variable Name      Default Value  Description
64342660Smarkm  -------------      -------------  -----------
64442660Smarkm  `automatic-footnotes' On	    When "On", footnotes appear and
64542660Smarkm				    disappear automatically.
64642660Smarkm
64742660Smarkm  `automatic-tiling'    Off	    When "On", creating of deleting a
64842660Smarkm				    window resizes other windows.
64942660Smarkm
65042660Smarkm  `visible-bell'        Off	    If non-zero, try to use a visible bell.
65142660Smarkm
65242660Smarkm  `errors-ring-bell'    On	    If non-zero, errors cause a ring.
65342660Smarkm
65442660Smarkm  `show-index-match'    On	    If non-zero, the portion of the string
65542660Smarkm				    matched is highlighted by changing its
65642660Smarkm				    case.
65742660Smarkm
65842660Smarkm  `scroll-behaviour'    Continuous  One of "Continuous", "Next Only", or
65942660Smarkm				    "Page Only".  "Page Only" prevents you from
66042660Smarkm				    scrolling past the bottom or top of a node.
66142660Smarkm				    "Next Only" causes the Next or Prev node to
66242660Smarkm				    be selected when you scroll past the bottom
66342660Smarkm				    or top of a node.  "Continous" moves
66442660Smarkm				    linearly through the files hierchichal
66542660Smarkm				    structure.
66642660Smarkm
66742660Smarkm  `scroll-step'	        0	    Controls how scrolling is done for you when
66842660Smarkm				    the cursor moves out of the current window.
66942660Smarkm				    Non-zero means it is the number of lines
67042660Smarkm				    you would like the screen to shift.  A
67142660Smarkm				    value of 0 means to center the line
67242660Smarkm				    containing the cursor in the window.
67342660Smarkm
67442660Smarkm  `gc-compressed-files' Off	    If non-zero means it is okay to reclaim the
67542660Smarkm				    file buffer space allocated to a file which
67642660Smarkm				    was compressed, if, and only if, that
67742660Smarkm				    file's contents do not appear in the node
67842660Smarkm				    list of any window.
67942660Smarkm
68042660Smarkm  `ISO-Latin'	        Off	    Non-zero means that you are using an ISO
68142660Smarkm				    Latin character set.  By default, standard
68242660Smarkm				    ASCII characters are assumed.
68342660Smarkm________________________________________
68442660SmarkmThis release of Info is version 2.5 beta.
68542660Smarkm
68642660SmarkmChanges since 2.4 beta:
68742660Smarkm
68842660Smarkm* Index (i) and (,) commands fully implemented.
68942660Smarkm* "configure" script now shipped with Info.
69042660Smarkm* New function "set-variable" allows users to set various variables.
69142660Smarkm* User-settable behaviour on end or beginning of node scrolling.  This
69242660Smarkm  supercedes the SPC and DEL changes in 2.3 beta.
69342660Smarkm
69442660Smarkm________________________________________
69542660SmarkmThis release of Info is version 2.4 beta.
69642660Smarkm
69742660SmarkmChanges since 2.3 beta:
69842660Smarkm
69942660Smarkm* info-last-node now means move to the last node of this info file.
70042660Smarkm* info-history-node means move backwards through this window's node history.
70142660Smarkm* info-first-node moves to the first node in the Info file.  This node is
70242660Smarkm  not necessarily "Top"!
70342660Smarkm* SPC and DEL can select the Next or Prev node after printing an informative
70442660Smarkm  message when pressed at the end/beg of a node.
70542660Smarkm
70642660Smarkm----------------------------------------
70742660SmarkmThis release of Info is version 2.3 beta.
70842660Smarkm
70942660SmarkmChanges since 2.2 beta:
71042660Smarkm
71142660Smarkm* M-x command lines if NAMED_COMMANDS is #defined.  Variable in Makefile.
71242660Smarkm* Screen height changes made quite robust.
71342660Smarkm* Interactive function "set-screen-height" implements user height changes.
71442660Smarkm* Scrolling on some terminals is faster now.
71542660Smarkm* C-l with numeric arguement is fixed.
71642660Smarkm
71742660Smarkm----------------------------------------
71842660SmarkmThis release of Info is version 2.2 beta.
71942660Smarkm
72042660SmarkmChanges since 2.0:
72142660Smarkm
72242660Smarkm* C-g can now interrupt multi-file searches.
72342660Smarkm* Incremental search is fully implemented.
72442660Smarkm* Loading large tag tables is much faster now.
72542660Smarkm* makedoc.c replaces shell script, speeding incremental builds.
72642660Smarkm* Scrolling in redisplay is implemented.
72742660Smarkm* Recursive uses of the echo area made more robust.
72842660Smarkm* Garbage collection of unreferenced nodes.
729