summaryrefslogtreecommitdiff
path: root/gnu/usr.bin/texinfo/README
blob: d1c2a60e08c8844c7d3fba6352831483780acb29 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
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.

PLEASE REPORT BUGS TO: bug-texinfo@prep.ai.mit.edu

23 March 1993

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.

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, to typeset Texinfo files for printing.

For instructions on 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.

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.


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.