Merge in texinfo-3.12.

git-svn-id: svn+ssh://gcc.gnu.org/svn/gcc/trunk@18811 138bc75d-0d04-0410-961f-82ee72b054a4

1 files changed, 122 insertions, 102 deletions

diff --git a/texinfo/dir-example b/texinfo/dir-example
index 9dc4fe33cc6..803e0479756 100644
--- a/texinfo/dir-example
+++ b/texinfo/dir-example
@@ -1,32 +1,39 @@
 This is the directory file `dir' a.k.a. `DIR', which contains the
-topmost node of the Info hierarchy.  This file is merely made available
-for your hacking pleasure, not official or standard in any way.
-If it doesn't make sense to you, or you don't like it, ignore it.
+  topmost node of the Info hierarchy.
+This particular dir file is merely made available for your hacking
+  pleasure, not official or standard in any way.  If it doesn't make sense
+  to you, or you don't like it, ignore it.
+If you have dir entries for Texinfo manuals you'd like to be added here,
+  please send them to karl@gnu.org.
 
-$Id: dir-example,v 1.3 1998/03/24 18:05:15 law Exp $
+$Id: dir-example,v 1.1.1.3 1998/03/24 18:19:30 law Exp $
 
-File: dir	Node: Top	This is the top of the INFO tree.
+File: dir,	Node: Top,	This is the top of the INFO tree.
 
-This node gives a menu of the major topics accessible through Info.
+This is the Info main menu (aka directory node).
+A few useful Info commands:
 
   `q' quits;
   `?' lists all Info commands;
   `h' starts the Info tutorial;
   `mTexinfo RET' visits the Texinfo manual, etc.
 
+Not all of the topics shown below may be available on this system.
+
 * Menu:
 
 GNU packages
-* Bash: (bash).			Bourne again shell.
-* Cpio: (cpio).			Cpio archiver.
-* DC: (dc).			Postfix arbitrary expression calculator.
+* Bash: (bash).			Bourne-Again SHell.
+* Cpio: (cpio).			Copy-in-copy-out archiver.
+* DC: (dc).			Postfix desk calculator.
 * Diff: (diff).			Comparing and merging programs.
 * Ed: (ed).			Line editor.
 * Emacs: (emacs).		Extensible self-documenting text editor.
-* File utilities: (fileutils).  GNU file utilities.
+* File utilities: (fileutils).	GNU file utilities.
 * Finding files: (find).	Operating on files matching certain criteria.
 * Font utilities: (fontu).	Programs for font manipulation.
-* Gawk: (gawk.info).            A text scanning and processing language.
+* Gawk: (gawk.info).		A text scanning and processing language.
+* Gcal: (gcal).			GNU calendar program.
 * Gzip: (gzip).			General (de)compression.
 * Identifier DB: (id-utils).	Identifier database utilities.
 * Ispell: (ispell).		Interactive spelling corrector.
@@ -34,13 +41,13 @@ GNU packages
 * Make: (make).			Remake files automatically.
 * Ptx: (ptx).			Permuted index generator.
 * Shar: (sharutils).		Shell archiver, uudecode/uuencode.
-* Shell utilities: (sh-utils).  GNU shell utilities.
+* Shell utilities: (sh-utils).	GNU shell utilities.
 * tar: (tar).			Making tape (or disk) archives.
-* Text utilities: (textutils).  GNU text utilities.
+* Text utilities: (textutils).	GNU text utilities.
 * Time: (time).			Measuring program resource usage.
 * UUCP: (uucp).			Copying between machines, offline.
 * Wdiff: (wdiff).		Word-by-word comparison.
-* Wget: (wget).                 URL download.
+* Wget: (wget).			URL download.
 
 GNU programming tools
 * As: (as).			Assembler.
@@ -61,20 +68,21 @@ GNU programming tools
 * Ld: (ld).			Linker.
 
 Texinfo documentation system
-* Info: (info).                 Documentation browsing system.
-* Texinfo: (texinfo).           The GNU documentation format.
+* Info: (info).			Documentation browsing system.
+* Texinfo: (texinfo).		The GNU documentation format.
 * info program: (info-stnd).	Standalone Info-reading program.
 * install-info: (texinfo)Invoking install-info. Updating info/dir entries.
-* texi2dvi: (texinfo)Format with texi2dvi.      Printing Texinfo documentation.
-* texindex: (texinfo)Format with tex/texindex.  Sorting Texinfo index files.
-* makeinfo: (texinfo)makeinfo preferred.        Translate Texinfo source.
+* texi2dvi: (texinfo)Format with texi2dvi.	Printing Texinfo documentation.
+* texindex: (texinfo)Format with tex/texindex.	Sorting Texinfo index files.
+* makeinfo: (texinfo)makeinfo preferred.	Translate Texinfo source.
 
 GNU Emacs Lisp
 * Elisp: (elisp).		GNU Emacs Lisp reference manual.
 * Intro Elisp: (emacs-lisp-intro). Introduction to Elisp programming.
 
+* AUC TeX: (auctex).		Editing (La)TeX files.
 * Calc: (calc).			Calculator and more.
-* CC-mode: (ccmode).		Editing C, C++, and Objective C.
+* CC mode: (cc-mode).		Editing C, C++, Objective C, and Java.
 * Common Lisp: (cl).		Partial Common Lisp support for Emacs Lisp.
 * Dired-x: (dired-x).		Extra directory editor features.
 * Edebug: (edebug).		Source-level debugger for Emacs Lisp.
@@ -121,9 +129,10 @@ GNU programming documentation
 * Stabs: (stabs).		Symbol table debugging information format.
 * Standards: (standards).	GNU coding standards.
 
-DOS
-* Demacs: (demacs).		GNU Emacs for DOS.
-* GNUish: (gnuish).		GNU utilities for DOS.
+Linux
+* dosemu: (dosemu).		Linux DOS emulator.
+* gpm: (gpm).			Linux general purpose mouse interface.
+* linux-faq: (linux-faq).	The Linux FAQ List
 
 TeX things
 * Afm2tfm: (dvips)Invoking afm2tfm.  Making Type 1 fonts available to TeX.
@@ -137,124 +146,133 @@ TeX things
 * TeXDraw: (texdraw).		Drawing PostScript diagrams within TeX.
 * Web2c: (web2c).		TeX, Metafont, and their companion programs.
 
+DOS 
+* Demacs: (demacs).		GNU Emacs for DOS.
+* GNUish: (gnuish).		GNU utilities for DOS.
+
 Other things
 * Amd: (amdref).		Filesystem automounter.
 * CMUCL: (cmu-user).		CMU Common Lisp.
 * File headers: (filehdr).	Bibliographic information for computer files.
 * GCP: (gcp).			Game club protocol.
+* GIMP: (pdb).			The GIMP procedural database.
 * HTML: (snafu).		Hypertext Markup Language 2.0 specification.
 * Jargon: (jargon).		The jargon file.
+* JED: (jed).			JED editor documentation.
+* octave: (octave).		Octave - A language for numerical computation.
 * Perl: (perl).			Practical extraction and report language.
 * PRCS: (prcs).			Project revision control system.
 * Screen: (screen).		Virtual screen manager.
 * UMB C.S. Dept.: (csinfo).	UMass/Boston Computer Science Dept. info.
 
 Individual utilities
-* aclocal: (automake)Invoking aclocal.          Generating aclocal.m4.
+* aclocal: (automake)Invoking aclocal.		Generating aclocal.m4.
 * aid: (id-utils)aid invocation.		Matching strings.
 * ar: (binutils)ar.				Create/modify/extract archives.
 * at-pr: (gnats)at-pr.				Bug report timely reminders.
-* automake: (automake).		                Making Makefile.in's.
+* automake: (automake).				Making Makefile.in's.
 * autoreconf: (autoconf)Invoking autoreconf.	Remake multiple configure's.
 * autoscan: (autoconf)Invoking autoscan.	Automate initial configure.in.
 * awk: (gawk)Invoking gawk.			Text processing and scanning.
-* basename: (sh-utils)basename invocation.      Strip directory and suffix.
+* basename: (sh-utils)basename invocation.	Strip directory and suffix.
 * bibtex: (web2c)BibTeX invocation.		Maintaining bibliographies.
 * c++filt: (binutils)c++filt.			Demangle C++ symbols.
-* cat: (textutils)cat invocation.               Concatenate and write files.
-* chgrp: (fileutils)chgrp invocation.           Change file groups.
-* chmod: (fileutils)chmod invocation.           Change file permissions.
-* chown: (fileutils)chown invocation.           Change file owners/groups.
-* chroot: (sh-utils)chroot invocation.          Specify the root directory.
-* cksum: (textutils)cksum invocation.           Print POSIX CRC checksum.
+* cat: (textutils)cat invocation.		Concatenate and write files.
+* chgrp: (fileutils)chgrp invocation.		Change file groups.
+* chmod: (fileutils)chmod invocation.		Change file permissions.
+* chown: (fileutils)chown invocation.		Change file owners/groups.
+* chroot: (sh-utils)chroot invocation.		Specify the root directory.
+* cksum: (textutils)cksum invocation.		Print POSIX CRC checksum.
 * cmp: (diff)Invoking cmp.			Character-by-character diff.
-* comm: (textutils)comm invocation.             Compare sorted files by line.
-* cp: (fileutils)cp invocation.                 Copy files.
-* csplit: (textutils)csplit invocation.         Split by context.
-* cut: (textutils)cut invocation.               Print selected parts of lines.
-* date: (sh-utils)date invocation.              Print/set system date and time.
-* dd: (fileutils)dd invocation.                 Copy and convert a file.
-* df: (fileutils)df invocation.                 Report filesystem disk usage.
+* comm: (textutils)comm invocation.		Compare sorted files by line.
+* cp: (fileutils)cp invocation.			Copy files.
+* csplit: (textutils)csplit invocation.		Split by context.
+* cut: (textutils)cut invocation.		Print selected parts of lines.
+* date: (sh-utils)date invocation.		Print/set system date and time.
+* dd: (fileutils)dd invocation.			Copy and convert a file.
+* df: (fileutils)df invocation.			Report filesystem disk usage.
 * diff3: (diff)Invoking diff3.			Three-way diff.
-* dir: (fileutils)dir invocation.               List directories briefly.
-* dircolors: (fileutils)dircolors invocation.   Color setup for ls.
-* dirname: (sh-utils)dirname invocation.        Strip non-directory suffix.
+* dir: (fileutils)dir invocation.		List directories briefly.
+* dircolors: (fileutils)dircolors invocation.	Color setup for ls.
+* dirname: (sh-utils)dirname invocation.	Strip non-directory suffix.
 * dmp: (web2c)Dmp invocation.			Troff->MPX (MetaPost pictures).
-* du: (fileutils)du invocation.                 Report on disk usage.
+* du: (fileutils)du invocation.			Report on disk usage.
 * dvicopy: (web2c)DVIcopy invocation.		Virtual font expansion
 * dvitomp: (web2c)DVItoMP invocation.		DVI to MPX (MetaPost pictures).
 * dvitype: (web2c)DVItype invocation.		DVI to human-readable text.
-* echo: (sh-utils)echo invocation.              Print a line of text.
+* echo: (sh-utils)echo invocation.		Print a line of text.
 * edit-pr: (gnats)Invoking edit-pr.		Changing bugs.
 * eid: (id-utils)eid invocation.		Invoking an editor on matches.
 * emacsclient: (emacs)Emacs Server.		Connecting to a running Emacs.
 * emacsserver: (emacs)Emacs Server.		Connecting to a running Emacs.
-* env: (sh-utils)env invocation.                Modify the environment.
+* env: (sh-utils)env invocation.		Modify the environment.
 * etags: (emacs)Create Tags Table.		Creating a TAGS table.
-* expand: (textutils)expand invocation.         Convert tabs to spaces.
-* expr: (sh-utils)expr invocation.              Evaluate expressions.
-* factor: (sh-utils)factor invocation.          Print prime factors
-* false: (sh-utils)false invocation.            Do nothing, unsuccessfully.
+* expand: (textutils)expand invocation.		Convert tabs to spaces.
+* expr: (sh-utils)expr invocation.		Evaluate expressions.
+* factor: (sh-utils)factor invocation.		Print prime factors
+* false: (sh-utils)false invocation.		Do nothing, unsuccessfully.
 * fid: (id-utils)fid invocation.		Listing a file's identifiers.
 * file-pr: (gnats)file-pr.			Processing incoming traffic.
 * find: (find)Invoking find.			Finding and acting on files.
-* fmt: (textutils)fmt invocation.               Reformat paragraph text.
-* fold: (textutils)fold invocation.             Wrap long input lines.
+* fmt: (textutils)fmt invocation.		Reformat paragraph text.
+* fold: (textutils)fold invocation.		Wrap long input lines.
 * g++: (gcc)Invoking G++.			The GNU C++ compiler.
+* gcal2txt: (gcal)Invoking gcal2txt.		Calendar resource to text file.
 * gettextize: (gettext)gettextize Invocation.	Prepare a package for gettext.
 * gftodvi: (web2c)GFtoDVI invocation.		Generic font proofsheets.
 * gftopk: (web2c)GFtoPK invocation.		Generic to packed fonts.
 * gftype: (web2c)GFtype invocation.		GF to human-readable text.
 * gid: (id-utils)gid invocation.		Listing all matching lines.
-* groups: (sh-utils)groups invocation.          Print group names a user is in.
+* git: (git).					GNU interactive tools.
+* groups: (sh-utils)groups invocation.		Print group names a user is in.
 * gunzip: (gzip)Overview.			Decompression.
-* head: (textutils)head invocation.             Output the first part of files.
-* hostname: (sh-utils)hostname invocation.      Print or set system name.
-* id: (sh-utils)id invocation.                  Print real/effective uid/gid.
+* head: (textutils)head invocation.		Output the first part of files.
+* hostname: (sh-utils)hostname invocation.	Print or set system name.
+* id: (sh-utils)id invocation.			Print real/effective uid/gid.
 * idx: (id-utils)idx invocation.		Testing mkid scanners.
 * ifnames: (autoconf)Invoking ifnames.		List conditionals in source.
 * iid: (id-utils)iid invocation.		Interactive complex queries.
 * inimf: (web2c)inimf invocation.		Initial Metafont.
 * inimp: (web2c)inimp invocation.		Initial MetaPost.
 * initex: (web2c)initex invocation.		Initial TeX.
-* install: (fileutils)install invocation.       Copy and change attributes.
-* join: (textutils)join invocation.             Join lines on a common field.
+* install: (fileutils)install invocation.	Copy and change attributes.
+* join: (textutils)join invocation.		Join lines on a common field.
 * kpsewhich: (kpathsea)Invoking kpsewhich.	TeX file searching.
 * lid: (id-utils)lid invocation.		Matching identifier patterns.
-* ln: (fileutils)ln invocation.                 Make links between files.
+* ln: (fileutils)ln invocation.			Make links between files.
 * locate: (find)Invoking locate.		Finding files in a database.
-* logname: (sh-utils)logname invocation.        Print current login name.
-* ls: (fileutils)ls invocation.                 List directory contents.
+* logname: (sh-utils)logname invocation.	Print current login name.
+* ls: (fileutils)ls invocation.			List directory contents.
 * makempx: (web2c)MakeMPX invocation.		MetaPost label typesetting.
 * maketexmf: (kpathsea)MakeTeX scripts.		MF source generation.
 * maketexpk: (kpathsea)MakeTeX scripts.		PK bitmap generation.
 * maketextex: (kpathsea)MakeTeX scripts.	TeX source generation.
 * maketextfm: (kpathsea)MakeTeX scripts.	TeX font metric generation.
-* md5sum: (textutils)md5sum invocation.         Print or check message-digests.
+* md5sum: (textutils)md5sum invocation.		Print or check message-digests.
 * mf: (web2c)mf invocation.			Creating typeface families.
 * mft: (web2c)MFT invocation.			Prettyprinting Metafont source.
-* mkdir: (fileutils)mkdir invocation.           Create directories.
-* mkfifo: (fileutils)mkfifo invocation.         Create FIFOs: (named pipes).
+* mkdir: (fileutils)mkdir invocation.		Create directories.
+* mkfifo: (fileutils)mkfifo invocation.		Create FIFOs: (named pipes).
 * mkid: (id-utils)mkid invocation.		Creating an ID database.
-* mknod: (fileutils)mknod invocation.           Create special files.
+* mknod: (fileutils)mknod invocation.		Create special files.
 * mp: (web2c)mp invocation.			Creating technical diagrams.
 * mpto: (web2c)MPto invocation.			MetaPost label extraction.
 * msgfmt: (gettext)msgfmt Invocation.		Make MO files out of PO files.
 * msgmerge: (gettext)msgmerge Invocation.	Update two PO files into one.
-* mv: (fileutils)mv invocation.                 Rename files.
+* mv: (fileutils)mv invocation.			Rename files.
 * newer: (web2c)Newer invocation.		Compare modification times.
-* nice: (sh-utils)nice invocation.              Modify scheduling priority.
-* nl: (textutils)nl invocation.                 Number lines and write files.
+* nice: (sh-utils)nice invocation.		Modify scheduling priority.
+* nl: (textutils)nl invocation.			Number lines and write files.
 * nlmconv: (binutils)nlmconv.			Convert object to NetWare LM.
 * nm: (binutils)nm.				List symbols in object files.
-* nohup: (sh-utils)nohup invocation.            Immunize to hangups.
+* nohup: (sh-utils)nohup invocation.		Immunize to hangups.
 * objcopy: (binutils)objcopy.			Copy/translate object files.
 * objdump: (binutils)objdump.			Display info from object files.
-* od: (textutils)od invocation.                 Dump files in octal, etc.
-* paste: (textutils)paste invocation.           Merge lines of files.
+* od: (textutils)od invocation.			Dump files in octal, etc.
+* paste: (textutils)paste invocation.		Merge lines of files.
 * patch: (diff)Invoking patch.			Automatically applying diffs.
 * patgen: (web2c)Patgen invocation.		Creating hyphenation patterns.
-* pathchk: (sh-utils)pathchk invocation.        Check file name portability.
+* pathchk: (sh-utils)pathchk invocation.	Check file name portability.
 * pid: (id-utils)pid invocation.		Looking up filenames.
 * pktogf: (web2c)PKtoGF invocation.		Packed to generic fonts.
 * pktype: (web2c)PKtype invocation.		PK to human-readable text.
@@ -262,60 +280,62 @@ Individual utilities
 * pooltype: (web2c)Pooltype invocation.		Display WEB pool files.
 * pr-addr: (gnats)pr-addr.			Bug report address retrieval.
 * pr-edit: (gnats)pr-edit.			The edit-pr driver.
-* pr: (textutils)pr invocation.                 Paginate or columnate files.
-* printenv: (sh-utils)printenv invocation.      Print environment variables.
-* printf: (sh-utils)printf invocation.          Format and print data.
-* pwd: (sh-utils)pwd invocation.                Print working directory.
+* pr: (textutils)pr invocation.			Paginate or columnate files.
+* printenv: (sh-utils)printenv invocation.	Print environment variables.
+* printf: (sh-utils)printf invocation.		Format and print data.
+* pwd: (sh-utils)pwd invocation.		Print working directory.
 * query-pr: (gnats)Invoking query-pr.		Bug searching/reporting.
 * queue-pr: (gnats)queue-pr.			Handling incoming traffic.
 * ranlib: (binutils)ranlib.			Index archive file contents.
-* rm: (fileutils)rm invocation.                 Remove files.
-* rmdir: (fileutils)rmdir invocation.           Remove empty directories.
+* rm: (fileutils)rm invocation.			Remove files.
+* rmdir: (fileutils)rmdir invocation.		Remove empty directories.
 * sdiff: (diff)Invoking sdiff.			Interactively merge files.
 * send-pr: (gnats)Invoking send-pr.		Submitting bugs.
-* seq: (sh-utils)seq invocation.                Print numeric sequences
+* seq: (sh-utils)seq invocation.		Print numeric sequences
 * shar: (sharutils)shar invocation.		Create shell archive.
 * size: (binutils)size.				List object file section sizes.
-* sleep: (sh-utils)sleep invocation.            Delay for a specified time.
-* sort: (textutils)sort invocation.             Sort text files.
-* split: (textutils)split invocation.           Split into fixed-size pieces.
+* sleep: (sh-utils)sleep invocation.		Delay for a specified time.
+* sort: (textutils)sort invocation.		Sort text files.
+* split: (textutils)split invocation.		Split into fixed-size pieces.
 * strings: (binutils)strings.			List printable strings.
 * strip: (binutils)strip.			Discard symbols.
-* stty: (sh-utils)stty invocation.              Print/change terminal settings.
-* su: (sh-utils)su invocation.                  Modify user and group id.
-* sum: (textutils)sum invocation.               Print traditional checksum.
-* sync: (fileutils)sync invocation.             Synchronize memory and disk.
+* stty: (sh-utils)stty invocation.		Print/change terminal settings.
+* su: (sh-utils)su invocation.			Modify user and group id.
+* sum: (textutils)sum invocation.		Print traditional checksum.
+* sync: (fileutils)sync invocation.		Synchronize memory and disk.
 * tabs: (tput)Invoking tabs.			Tab settings.
-* tac: (textutils)tac invocation.               Reverse files.
-* tail: (textutils)tail invocation.             Output the last part of files.
+* tac: (textutils)tac invocation.		Reverse files.
+* tail: (textutils)tail invocation.		Output the last part of files.
 * tangle: (web2c)Tangle invocation.		WEB to Pascal.
-* tee: (sh-utils)tee invocation.                Redirect to multiple files.
-* test: (sh-utils)test invocation.              File/string tests.
+* tcal: (gcal)Invoking tcal.			Run Gcal with tomorrow's date.
+* tee: (sh-utils)tee invocation.		Redirect to multiple files.
+* test: (sh-utils)test invocation.		File/string tests.
 * tex: (web2c)tex invocation.			Typesetting.
 * tftopl: (web2c)TFtoPL invocation.		TFM -> property list.
-* touch: (fileutils)touch invocation.           Change file timestamps.
+* touch: (fileutils)touch invocation.		Change file timestamps.
 * tput: (tput)Invoking tput.			Termcap in shell scripts.
-* tr: (textutils)tr invocation.                 Translate characters.
-* true: (sh-utils)true invocation.              Do nothing, successfully.
-* tty: (sh-utils)tty invocation.                Print terminal name.
-* uname: (sh-utils)uname invocation.            Print system information.
-* unexpand: (textutils)unexpand invocation.     Convert spaces to tabs.
-* uniq: (textutils)uniq invocation.             Uniqify files.
+* tr: (textutils)tr invocation.			Translate characters.
+* true: (sh-utils)true invocation.		Do nothing, successfully.
+* tty: (sh-utils)tty invocation.		Print terminal name.
+* txt2gcal: (gcal)Invoking txt2gcal.		Calendar text to resource file.
+* uname: (sh-utils)uname invocation.		Print system information.
+* unexpand: (textutils)unexpand invocation.	Convert spaces to tabs.
+* uniq: (textutils)uniq invocation.		Uniqify files.
 * unshar: (sharutils)unshar invocation.		Extract from shell archive.
 * updatedb: (find)Invoking updatedb.		Building the locate database.
-* users: (sh-utils)users invocation.            Print current user names.
-* vdir: (fileutils)vdir invocation.             List directories verbosely.
+* users: (sh-utils)users invocation.		Print current user names.
+* vdir: (fileutils)vdir invocation.		List directories verbosely.
 * vftovp: (web2c)VFtoVP invocation.		Virtual font -> virtual pl.
 * view-pr: (gnats)Invoking view-pr.		Showing bug reports.
 * virmf: (web2c)virmf invocation.		Virgin Metafont.
 * virmp: (web2c)virmp invocation.		Virgin MetaPost.
 * virtex: (web2c)virtex invocation.		Virgin TeX.
 * vptovf: (web2c)VPtoVF invocation.		Virtual pl -> virtual font.
-* wc: (textutils)wc invocation.                 Byte, word, and line counts.
+* wc: (textutils)wc invocation.			Byte, word, and line counts.
 * weave: (web2c)Weave invocation.		WEB to TeX.
-* who: (sh-utils)who invocation.                Print who is logged in.
-* whoami: (sh-utils)whoami invocation.          Print effective user id.
+* who: (sh-utils)who invocation.		Print who is logged in.
+* whoami: (sh-utils)whoami invocation.		Print effective user id.
 * xargs: (find)Invoking xargs.			Operating on many files.
 * xgettext: (gettext)xgettext Invocation.	Extract strings into a PO file.
-* yes: (sh-utils)yes invocation.                Print a string indefinitely.
+* yes: (sh-utils)yes invocation.		Print a string indefinitely.
 * zcat: (gzip)Overview.				Decompression to stdout.