contrib/texinfo/NEWS

   1 Copyright (C) 1992, 93, 94, 95, 96, 97, 98, 99, 2000, 01, 02
   2 Free Software Foundation, Inc.
   3
   4 Permission is granted to copy, distribute and/or modify this document
   5 under the terms of the GNU Free Documentation License, Version 1.1 or
   6 any later version published by the Free Software Foundation; with no
   7 Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts.
   8
   9 This file records noteworthy changes.
  10
  11
  12 *** IMPORTANT NEWS FOR ALL AUTHORS OF TEXINFO MANUALS ***
  13
  14 As of version 4.2, Texinfo has a new command @copying to define the
  15 copyright and copying permissions for a manual.  It's important to
  16 switch to using it as soon as possible (as in your next release),
  17 because the historical method of doing copyright permissions using
  18 @ifinfo failed to output copyright information in the HTML (or XML)
  19 formats.  The manual has detailed explanations and examples.  For
  20 convenience, here's a url to one of the relevant sections:
  21   http://texinfo.org/manual/Document-Permissions.html
  22
  23
  24 \f
  25 4.2 (1 April 2002)
  26 * Language:
  27   . new command @copying to define copying permissions.  See above.
  28   . new conditionals @ifplaintext, @ifnotplaintext for the plain text
  29     (--no-headers) output format.
  30   . new command @\ to produce literal \ inside @math, since \ by itself
  31     no longer works.
  32 * makeinfo:
  33   . emit accesskey attributes for keyboard shortcuts to menu items.
  34   . @{even,every,odd}{footing,header} are ignored by makeinfo now, so
  35     they no longer need to be enclosed in @iftex.
  36 * texinfo.tex:
  37   . bug fix for pdf-format table of contents.
  38 * info:
  39   . bug fixes for -R (--raw-escapes).
  40   . --help shows short option names.
  41 * Distribution:
  42   . the doc.c, funs.h, and key.c files in info/ are no longer generated
  43     at make time, to appease Automake's make distcheck.
  44   . gettext 0.11.1, autoconf 2.53, automake 1.6 (with install-info kludge).
  45
  46
  47 \f
  48 4.1 (4 March 2002)
  49 * Language:
  50   . new commands @verbatim and @verb for printing verbatim inserts.
  51   . new command @verbatiminclude for verbatim include of files.
  52   . new environment @documentdescription for defining the HTML description.
  53   . new command @afivepaper for the A5 paper size.
  54 * makeinfo:
  55   . supports xml and docbook output.
  56   . supports HTML splitting by node, which is now the default.
  57   . new option --split-size to control maximum size of split info files.
  58 * info:
  59   . user-specified key bindings supported.
  60   . ANSI escape sequences (as produced by groff) removed from man output
  61     by default; use --raw-escapes to let them through if your terminal
  62     supports them.
  63 * texinfo.tex:
  64   . @math implies @tex, so all the usual plain TeX math is supported.
  65   . smaller fonts for @smallexample, in all page sizes.
  66   . improvements in the PDF support.
  67 * texi2dvi:
  68   . new option -o to explicitly specify output filename.
  69 * Distribution:
  70   . switch to GNU Free Documentation License (http://www.gnu.org/copyleft/).
  71   . update to GNU gettext 0.11, autoconf 2.52, and automake 1.5.
  72   . Danish, Swedish, and Hebrew message translations.
  73
  74 \f
  75 4.0 (28 September 1999)
  76 * Language:
  77   . New command @anchor for cross references to arbitrary points.
  78   . New commands @documentlanguage sets the main document language,
  79     and @documentencoding sets the document input encoding (although not
  80     much is done yet with either).
  81   . New command @pagesizes allows limited control of text area for typesetting.
  82   . New command @acronym for abbreviations in all caps, such as `NASA'.
  83   . New command @alias for simple command aliases.
  84   . New command @definfoenclose for better control of info output.
  85   . New commands @deftypeivar for typed instance variables of a class
  86     and @deftypeop for typed operations of a class.
  87   . New command @novalidate suppresses cross-reference checking and (in
  88     TeX) auxiliary file creation.
  89   . New commands @setcontentsaftertitlepage and
  90     @setshortcontentsaftertitlepage to force printing the table of
  91     contents after @end titlepage.  Also, @contents and @shortcontents
  92     themselves can now appear at the beginning of the document as
  93     well as the end.
  94   . New markup commands: @env (for environment variables), @command (for
  95     command names), @option (for command-line options).
  96   . New commands @smallformat and @smalldisplay, a la @smallexample.
  97   . New command @exampleindent to set indentation of example-like
  98     environments a la @paragraphindent.
  99   . @uref takes an optional third argument of text to show instead of
 100     (rather than in addition to) the url for info and dvi output.
 101   . @footnote works in an @item for a @table.
 102 * texinfo.tex:
 103   . latest version always at ftp://ftp.gnu.org/gnu/texinfo.tex (and mirrors).
 104   . implements @macro.
 105   . implements @paragraphindent (except asis).
 106   . @emph and @i use true italic type (cmti) instead of slanted (cmsl).
 107   . implements pdf output when run with pdftex.
 108   . better support for internationalization via txi-??.tex files.
 109   . footnotes now set in a smaller point size.
 110 * makeinfo:
 111   . supports HTML output with the --html option.
 112   . implication of --html: @top nodes should be wrapped in @ifnottex
 113     rather than @ifinfo.  @ifinfo conditionals are not expanded with --html.
 114   . new option --number-sections to output chapter/section numbers.
 115   . dashes and quotes are not treated specially in node names.
 116   . new option --commands-in-node-names to allow @-commands in node names.
 117     (Not implemented in TeX, and most likely never will be.)
 118   . @emph output uses _underscores_.
 119   . @image looks for .png files before .jpg.
 120   . only output `Making ... file' line when verbose.
 121   . allow -v as synonym for --verbose.
 122   . new command line options to specify which conditionals to process
 123     (but --iftex is not fully implemented).
 124   . warns if @var contains any of ,[]().
 125   . @quote-arg implicitly done for all one-argument macros, so commas in
 126     the argument text are allowed.
 127   . \\ required in macro body to get single \, no other `escapes' defined.
 128 * info:
 129   . ISO Latin 1 characters are displayed and input as-is by default.
 130   . new option --vi-keys to enable vi-like and less-like key bindings.
 131   . new command S does case-sensitive searching.
 132   . new commands C-x n and C-x N repeat last search, respectively, in the
 133     same and in reverse direction, without prompting for the string.  These
 134     commands are bound to n and N under --vi-keys, like in Less.
 135   . new command G menu1 menu2 ... searches for menu items from (dir),
 136     as allowed on the command line.
 137   . new command O (capital o, not zero) goes directly to the node that
 138     describes command-line options.
 139   . new command-line option --show-options causes the node which
 140     describes command-line options to be the first node displayed.
 141   . M-prior and M-DEL do new command info-scroll-other-window-backward.
 142   . / searches like s does.
 143   . If the search string includes upper-case letters, in both incremental
 144     and non-incremental search, the search is case-sensitive.
 145   . S searches case-sensitively even if the search string is all
 146     lower-case.
 147   . - makes the argument negative (so e.g. `- /' searches backward).
 148   . l restores point in the window returned to.
 149   . SPC/DEL do not move outside the current document.
 150   . foo.info is found before foo.
 151   . `info foo --index-search=bar' now searches for bar in foo's index.
 152   . support for files compressed with bzip2.
 153 * install-info:
 154   . handles gzipped dir files.
 155   . sort entries into alphabetical order.
 156   . install direntries only in preceding dircategory, not in all.
 157   . --delete does not require the info file to exist.
 158   . --delete can handle XEmacs-style dir entries.
 159 * texi2dvi:
 160   . bug fixed: now uses only the @iftex and @tex parts of the source.
 161   . process LaTeX source as well as Texinfo source.
 162   . output PDF (using pdftex) with new option --pdf.
 163   . handles --OPTION=ARG style of command line arguments.
 164   . new option --batch for progress reports but no interaction.
 165   . new option --clean to remove all auxiliary files.
 166   . new option --quiet for silence (unless there are errors).
 167   . new option -I for specifying directories for @include to search.
 168   . handles LaTeX files (running BibTeX etc.).
 169 * Fixes to util/gen-dir-node and util/fix-info-dir (formerly util/update-info).
 170 * Distribution:
 171   . Man pages included.
 172   . Czech and Norwegian message translations.
 173   . Various translations for texinfo.tex fixed words included.
 174   . DJGPP support.
 175
 176 \f
 177 3.12 (3 March 1998)
 178 * Elisp files removed, since they are only usefully distributed with Emacs.
 179 * Restore inclusion of compile-time $(infodir) to INFOPATH.
 180 * install-info creates a proper dir file.
 181 * Various portability fixes.
 182
 183 \f
 184 3.11 (31 July 1997)
 185 * New commands:
 186   - @uref to make a reference to a url; @url now only indicates such.
 187   - @image to include graphics (epsf for TeX).
 188   - @deftypemethod and @deftypemethodx to document methods in strongly
 189     typed object-oriented languages, such as C++.
 190   - @html for raw HTML.
 191   - @ifnothtml @ifnotinfo @ifnottex for more precise conditionals.
 192   - @kbdinputstyle to control when @kbd uses the slanted typewriter font.
 193   - @email takes second optional argument.
 194 * texinfo.tex reads texinfo.cnf (if present) for site-wide TeX
 195   configuration; for example, A4 paper sizes.
 196 * info:
 197   - arrow keys supported.
 198   - trailing : in INFOPATH appends default path.
 199   - new option --index-search for online help support.
 200 * makeinfo:
 201   - output files removed if errors unless (new option) --force.
 202   - new option -P to prepend to search path.
 203   - macro expansion file can be standard output.
 204 * install-info creates a new dir file if necessary.
 205 * update-info script to create a dir file from all info files.
 206 * Elisp: texnfo-tex.el and detexinfo.el removed from the distribution;
 207   - texnfo-tex features are now part of standard TeX & Texinfo packages;
 208   - makeinfo --no-headers does a better job than detexinfo.el.
 209 * Documentation:
 210   - Updates, revisions, corrections in the manual.
 211   - makeinfo.texi removed, as it was a copy of what was in texinfo.texi.
 212 * gettext support in sources, French and German translations included.
 213 * info man page removed; use the Texinfo manual.
 214 * Automake used, other portability fixes.
 215
 216 3.10 (nonexistent)
 217
 218 \f
 219 3.9 (4 October 1996)
 220 * makeinfo:
 221   - Give a suppressible (with --no-validate) error for references
 222     outside of any node.
 223   - Keep track of multitable output correctly for split files; this
 224     caused nodes after the first multitable to be ``undefined''.
 225 * install-info:
 226   - Rename --infodir option to --info-dir.
 227   - More robust error checking to avoid various crashes.
 228 * configure: Include replacements for memcpy and memmove functions in
 229   the distribution, in case they are missing.
 230
 231 \f
 232 3.8 (30 September 1996)
 233 * Define and/or document new and/or previously existing commands:
 234   Accents: @" @' @, @" @= @^ @` @~ @H @d @dotaccent @dotless @ringaccent
 235     @tieaccent @u @ubaraccent @v
 236   Special characters: @AA @AE @L @O @OE @aa @ae @exclamdown @l @o @oe
 237     @pounds @questiondown @ss
 238   Special punctuation: @! @? @enddots
 239   dir file maintenance: @dircategory @direntry; also new program, install-info
 240   HTML support: @email @url @ifhtml...@end ifhtml
 241   Macros: @macro @unmacro
 242   Tables: @multitable @tab
 243   Hyphenation: @- @hyphenation
 244   Spacing: @  @<TAB> @<NEWLINE>
 245   Sectioning:
 246     @headings singleafter/doubleafter (change heading style after current page)
 247     @centerchap
 248     @setchapterstyle
 249   Other:
 250     @shorttitlepage (simple title pages)
 251     @detailmenu...@end detailmenu (help makeinfo parse master menus)
 252 * Makeinfo prefers an input file named `foo.texinfo' or `foo.texi' or
 253   `foo.txinfo' to just `foo' (the latter most likely being an executable).
 254 * Makeinfo implements @. @! @? correctly, as end-of-sentence punctuation.
 255 * @key marks its argument with a lozenge in TeX and <...> in Info.
 256 * TeX output has substantially decreased interline spacing and other
 257   formatting changes.
 258 * Remove these obsolete and never-documented commands:
 259     @infotop
 260     @infoappendix @infoappendixsec @infoappendixsubsec @infoappendixsubsubsec
 261     @infochapter @infosection @infosubsection @infosubsubsection
 262     @infounnumbered @infounnumberedsec @infounnumberedsubsec
 263       @infounnumberedsubsubsec
 264     @input
 265     @smallbreak @medbreak
 266     @overfullrule
 267     @br
 268 * Deprecate these obsolete commands, to be removed in the next release:
 269     @ctrl
 270     @infoinclude
 271     @iappendix @iappendixsection @iappendixsec @iappendixsubsec
 272       @iappendixsubsubsec
 273     @ichapter @isection @isubsection @isubsubsection
 274     @iunnumbered @iunnumberedsec @iunnumberedsubsec @iunnumberedsubsubsec
 275     @setchapterstyle
 276     @titlespec
 277
 278 \f
 279 3.7 (24 December 1995)
 280 * Have --version print texinfo release number as well as the individual
 281   program version.
 282 * Better man page cleaning.
 283 * Update Elisp files from current Emacs release.
 284
 285 \f
 286 3.6 (21 June 1995)
 287 * Unmatched brace error reporting improved.
 288 * Missing comment terminator prevented compilation.
 289
 290 \f
 291 3.5 (20 June 1995)
 292 * Autoconf update.
 293 * Support for parallel makes.
 294 * make install does not install Elisp files.
 295
 296 \f
 297 3.4 (19 June 1995)
 298 * Handle @ifhtml in Elisp.
 299 * Update FSF address.
 300
 301 \f
 302 3.3 (15 June 1995)
 303 * Portability changes.
 304 * Compile Elisp files.
 305 * Don't distribute .info* files.
 306
 307 \f
 308 3.2 (9 June 1995)
 309 * Standalone Info can read Unix man pages.
 310 * New commands: @! @? @^ @" @enddots.
 311 * makeinfo -E does macro expansion (and nothing else).
 312
 313 \f
 314 3.1 (23 May 1993)
 315 Just bug fixes, see ChangeLog for full details.
 316
 317 \f
 318 3.0: first release of Texinfo version 2, with many new commands.
 319
 320
 321 \f
 322 Here is the separate NEWS for old releases of Info:
 323
 324 Version 2.11,     Sat Apr  1 09:15:21 1995
 325
 326 Changes since 2.7 beta:
 327
 328 Although the basic code remains the same, there are numerous nits
 329 fixed, including some display bugs, and a memory leak.  Some changes
 330 that have taken place with larger impact include the way in which the
 331 (dir) node is built; I have added in support for "localdir"
 332 directories among other things.  Info files may be stored in
 333 compressed formats, and in their own subdirectories; menu items which
 334 do not explicitly name the node to which they are attached have the
 335 menu item name looked up as an Info file if it is not found within the
 336 current document.  This means that the menu item:
 337
 338 * Info::                The Info documentation reader.
 339
 340 in (dir) refers to the info node "(info)Top".
 341
 342 Please see the ChangeLog and documentation for details on other
 343 changes.
 344
 345 Version 2.7 beta, Wed Dec 30 02:02:38 1992
 346 Version 2.6 beta, Tue Dec 22 03:58:07 1992
 347 Version 2.5 beta, Tue Dec  8 14:50:35 1992
 348 Version 2.4 beta, Sat Nov 28 14:34:02 1992
 349 Version 2.3 beta, Fri Nov 27 01:04:13 1992
 350 Version 2.2 beta, Tue Nov 24 09:36:08 1992
 351 Version 2.1 beta, Tue Nov 17 23:29:36 1992
 352
 353 Changes since 2.5 beta:
 354
 355 Note that versions 2.6 and 2.7 Beta were only released to a select group.
 356
 357 * "info-" removed from the front of M-x commands.
 358
 359 * Automatic footnote display.  When you enter a node which contains
 360   footnotes, and the variable "automatic-footnotes" is "On", Info pops
 361   up a window containing the footnotes.  Likewise, when you leave that
 362   node, the window containing the footnotes goes away.
 363
 364 * Cleaner built in documentation, and documentation functions.
 365
 366   Use:
 367     o `M-x describe-variable' to read a variable's documenation
 368     o `M-x describe-key' to find out what a particular keystroke does.
 369     o `M-x describe-function' to read a function's documentation.
 370     o `M-x where-is' to find out what keys invoke a particular function.
 371
 372 * Info can "tile" the displayed windows (via "M-x tile-windows").  If
 373   the variable "automatic-tiling" is "On", then splitting a window or
 374   deleting a window causes the remaining windows to be retiled.
 375
 376 * You can save every keystroke you type in a "dribble file" by using the
 377   `--dribble FILENAME' option.  You can initially read keystrokes from an
 378   alternate input stream with `--restore FILENAME', or by redirecting
 379   input on the command line `info < old-dribble'.
 380
 381 * New behaviour of menu items.  If the label is the same as the
 382   target node name, and the node couldn't be found in the current file,
 383   treat the label as a file name.  For example, a menu entry in "DIR"
 384   might contain:
 385
 386     * Emacs::           Cool text-editor.
 387
 388   Info would not find the node "(dir)Emacs", so just plain "(emacs)"
 389   would be tried.
 390
 391 * New variable "ISO-Latin" allows you to use European machines with
 392   8-bit character sets.
 393
 394 * Cleanups in echo area reading, and redisplay.  Cleanups in handling the
 395   window which shows possible completions.
 396
 397 * Info can now read files that have been compressed.  An array in filesys.c
 398   maps extensions to programs that can decompress stdin, and write the results
 399   to stdout.  Currently, ".Z"/uncompress, ".z"/gunzip, and ".Y"/unyabba are
 400   supported.  The modeline for a compressed file shows "zz" in it.
 401
 402 * There is a new variable "gc-compressed-files" which, if non-zero, says
 403   it is okay to reclaim the file buffer space allocated to a file which
 404   was compressed, if, and only if, that file's contents do not appear in
 405   any history node.
 406
 407 * New file `nodemenu.c' implements a few functions for manipulating
 408   previously visited nodes.  `C-x C-b' (list-visited-nodes) produces a
 409   menu of the nodes that could be reached by info-history-node in some
 410   window.  `C-x b' (select-visited-node) is similar, but reads one of
 411   the node names with completion.
 412
 413 * Keystroke `M-r' (move_to_screen_line) allows the user to place the cursor at
 414   the start of a specific screen line.  Without a numeric argument, place the
 415   cursor on the center line; with an arg, place the cursor on that line.
 416
 417 * Interruptible display implemented.  Basic display speedups and hacks.
 418 * The message "*** Tags Out of Date ***" now means what it says.
 419 * Index searching with `,' (info-index-next) has been improved.
 420 * When scrolling with C-v, C-M-v, or M-v, only "Page Only" scrolling
 421   will happen.
 422
 423 * Continous scrolling (along with `]' (info-global-next) and `['
 424   (info-global-prev) works better.  `]' and `[' accept numeric
 425   arguments, moving that many nodes in that case.
 426
 427 * `C-x w' (info-toggle-wrap) controls how lines wider than the width
 428   of the screen are displayed.  If a line is too long, a `$' is
 429   displayed in the rightmost column of the window.
 430
 431 * There are some new variables for controlling the behaviour of Info
 432   interactively.  The current list of variables is as follows:
 433
 434   Variable Name      Default Value  Description
 435   -------------      -------------  -----------
 436   `automatic-footnotes' On          When "On", footnotes appear and
 437                                     disappear automatically.
 438
 439   `automatic-tiling'    Off         When "On", creating of deleting a
 440                                     window resizes other windows.
 441
 442   `visible-bell'        Off         If non-zero, try to use a visible bell.
 443
 444   `errors-ring-bell'    On          If non-zero, errors cause a ring.
 445
 446   `show-index-match'    On          If non-zero, the portion of the string
 447                                     matched is highlighted by changing its
 448                                     case.
 449
 450   `scroll-behaviour'    Continuous  One of "Continuous", "Next Only", or
 451                                     "Page Only".  "Page Only" prevents you from
 452                                     scrolling past the bottom or top of a node.
 453                                     "Next Only" causes the Next or Prev node to
 454                                     be selected when you scroll past the bottom
 455                                     or top of a node.  "Continous" moves
 456                                     linearly through the files hierchichal
 457                                     structure.
 458
 459   `scroll-step'         0           Controls how scrolling is done for you when
 460                                     the cursor moves out of the current window.
 461                                     Non-zero means it is the number of lines
 462                                     you would like the screen to shift.  A
 463                                     value of 0 means to center the line
 464                                     containing the cursor in the window.
 465
 466   `gc-compressed-files' Off         If non-zero means it is okay to reclaim the
 467                                     file buffer space allocated to a file which
 468                                     was compressed, if, and only if, that
 469                                     file's contents do not appear in the node
 470                                     list of any window.
 471
 472   `ISO-Latin'           Off         Non-zero means that you are using an ISO
 473                                     Latin character set.  By default, standard
 474                                     ASCII characters are assumed.
 475 ________________________________________
 476 This release of Info is version 2.5 beta.
 477
 478 Changes since 2.4 beta:
 479
 480 * Index (i) and (,) commands fully implemented.
 481 * "configure" script now shipped with Info.
 482 * New function "set-variable" allows users to set various variables.
 483 * User-settable behaviour on end or beginning of node scrolling.  This
 484   supercedes the SPC and DEL changes in 2.3 beta.
 485
 486 ________________________________________
 487 This release of Info is version 2.4 beta.
 488
 489 Changes since 2.3 beta:
 490
 491 * info-last-node now means move to the last node of this info file.
 492 * info-history-node means move backwards through this window's node history.
 493 * info-first-node moves to the first node in the Info file.  This node is
 494   not necessarily "Top"!
 495 * SPC and DEL can select the Next or Prev node after printing an informative
 496   message when pressed at the end/beg of a node.
 497
 498 ----------------------------------------
 499 This release of Info is version 2.3 beta.
 500
 501 Changes since 2.2 beta:
 502
 503 * M-x command lines if NAMED_COMMANDS is #defined.  Variable in Makefile.
 504 * Screen height changes made quite robust.
 505 * Interactive function "set-screen-height" implements user height changes.
 506 * Scrolling on some terminals is faster now.
 507 * C-l with numeric arguement is fixed.
 508
 509 ----------------------------------------
 510 This release of Info is version 2.2 beta.
 511
 512 Changes since 2.0:
 513
 514 * C-g can now interrupt multi-file searches.
 515 * Incremental search is fully implemented.
 516 * Loading large tag tables is much faster now.
 517 * makedoc.c replaces shell script, speeding incremental builds.
 518 * Scrolling in redisplay is implemented.
 519 * Recursive uses of the echo area made more robust.
 520 * Garbage collection of unreferenced nodes.