Texinfo, Version 3 ================== This is the README file for version 3 of the Texinfo distribution. Files within this distribution have their own version and edition numbers. When you refer to a file, please mention its own number, as well as the version number of the Texinfo distribution. PLEASE REPORT BUGS TO: bug-texinfo@prep.ai.mit.edu Texinfo is a documentation system that uses a single source file to produce both on-line information and printed output. This means that instead of writing two different documents, one for the on-line help or other on-line information and the other for a typeset manual or other printed work, you need write only one document. When the work is revised, you need revise only one document. You can read the on-line information, known as an "Info file", with an Info documentation-reading program. By convention, Texinfo source file names end with a `.texi' or `.texinfo' extension. Texinfo is described in the Texinfo manual (the file ./texinfo.texi). You can write and format Texinfo files into Info files within GNU Emacs, and read them using the Emacs Info reader. If you do not have Emacs, you can format Texinfo files into Info files using `makeinfo' and read them using `info'. Use TeX, which is not included in this package (see `How to Obtain TeX' in the Texinfo manual for information), to typeset Texinfo files for printing. For instructions on compiling and installing info, makeinfo, texi2dvi, and texindex, please read the file `INSTALL'. The Emacs Lisp files are not installed by default; to install them, use `make install' in the `emacs' subdirectory. The Info tree uses a file `dir' as its root node; a sample `dir' file is included in the distribution, but not installed anywhere. Use it or not as you like. This distribution includes (but is not limited to) the following files: README This file. INTRODUCTION This file tells you how to create readable files from the Texinfo source files in this distribution. Texinfo source files: texinfo.texi This manual describes Texinfo. It tells how to use Texinfo to write documentation, how to use Texinfo mode in GNU Emacs, how to use TeX, makeinfo, and the Emacs Lisp Texinfo formatting commands. info.texi This manual tells you how to use Info. This document comes as part of GNU Emacs. If you do not have Emacs, you can format this Texinfo source file with makeinfo or TeX and then read the resulting Info file with the standalone Info reader that is part of this distribution. info-stnd.texi This manual tells you how to use the standalone GNU Info reader that is included in this distribution as a C source file, `info.c'. makeinfo.texi This manual tells you how to use makeinfo. The same information is contained in a chapter of the Texinfo manual; it has been extracted here for your convenience. Printing related files: texinfo.tex This TeX definitions file tells the TeX program how to typeset a Texinfo file into a DVI file ready for printing. texindex.c This file contains the source for the `texindex' program that generates sorted indices used by TeX when typesetting a file for printing. texi2dvi This is a shell script for producing an indexed DVI file using TeX and texindex. Must be used if the source document uses Texinfo @macros. GNU Emacs related files: texinfmt.el This Emacs Lisp file provides the functions that GNU Emacs uses to format a Texinfo file into an Info file. texinfo.el This file provides Texinfo mode for GNU Emacs. texnfo-upd.el These files provides commands to texnfo-tex.el help you write Texinfo files makeinfo.el using GNU Emacs Texinfo mode. detexinfo.el This extra utility file contains functions to remove Texinfo commands from a Texinfo source file. info.el These are the standard GNU Emacs informat.el Info reading and support files, included here for your convenience. Source files for standalone C programs: makeinfo.c This file contains the source for the `makeinfo' program that you can use to create an Info file from a Texinfo file. info.c This file contains the source for the `info' program that you can use to view Info files on an ASCII terminal. getopt.c Various support files getopt1.c getopt.h C Installation files: configure This file creates creates a Makefile which in turn creates an `info' or `makeinfo' executable, or a C sources distribution. configure.in This is a template for creating `configure' using m4 macros. Makefile.in This is a template for `configure' to use to make a Makefile. Other files: NEWS This contains a summary of new features since the first edition of Texinfo. info.1 This is a `man' page that briefly describes the standalone `info' program. fixfonts This is a shell script to install the `lcircle10' TeX fonts as an alias for the `circle10' fonts. In some older TeX distributions the names are different. tex3patch This handles a bug for version 3.0 of TeX that does not occur in more recent versions.