comparison man/texinfo.texi @ 371:cc15677e0335 r21-2b1

Import from CVS: tag r21-2b1
author cvs
date Mon, 13 Aug 2007 11:03:08 +0200
parents a4f53d9b3154
children 7d59cb494b73
comparison
equal deleted inserted replaced
370:bd866891f083 371:cc15677e0335
1 \input texinfo.tex @c -*-texinfo-*- 1 \input texinfo.tex @c -*-texinfo-*-
2 @c $Id: texinfo.texi,v 1.13 2001/01/07 03:21:58 vins Exp $ 2 @c $Id: texinfo.texi,v 1.8 1998/06/30 06:35:31 steve Exp $
3 @c %**start of header 3 @c %**start of header
4 4
5 @c All text is ignored before the setfilename. 5 @c All text is ignored before the setfilename.
6 @setfilename ../info/texinfo.info 6 @setfilename ../info/texinfo
7 @settitle Texinfo @value{edition} 7 @settitle Texinfo @value{edition}
8 8
9 @c Edition number is now the same as the Texinfo distribution version number. 9 @c Edition number is now the same as the Texinfo distribution version number.
10 @set edition 3.12 10 @set edition 3.12
11 @set update-month February 1998 11 @set update-month February 1998
646 * Tagifying:: How to tagify a file. 646 * Tagifying:: How to tagify a file.
647 * Splitting:: How to split a file manually. 647 * Splitting:: How to split a file manually.
648 648
649 How to Obtain @TeX{} 649 How to Obtain @TeX{}
650 650
651 @c * New Texinfo Mode Commands:: The updating commands are especially useful. 651 * New Texinfo Mode Commands:: The updating commands are especially useful.
652 @c * New Commands:: Many newly described @@-commands. 652 * New Commands:: Many newly described @@-commands.
653 @end detailmenu 653 @end detailmenu
654 @end menu 654 @end menu
655 655
656 @node Copying, Overview, Top, Top 656 @node Copying, Overview, Top, Top
657 @comment node-name, next, previous, up 657 @comment node-name, next, previous, up
741 and indices. From the same Texinfo source file, you can create a 741 and indices. From the same Texinfo source file, you can create a
742 menu-driven, on-line Info file with nodes, menus, cross references, 742 menu-driven, on-line Info file with nodes, menus, cross references,
743 and indices. You can, if you wish, make the chapters and sections of 743 and indices. You can, if you wish, make the chapters and sections of
744 the printed document correspond to the nodes of the on-line 744 the printed document correspond to the nodes of the on-line
745 information; and you use the same cross references and indices for 745 information; and you use the same cross references and indices for
746 both the Info file and the printed work. @cite{The XEmacs User's 746 both the Info file and the printed work. @cite{The GNU
747 Manual} is a good example of a Texinfo file, as is this manual.@refill 747 Emacs Manual} is a good example of a Texinfo file, as is this manual.@refill
748 748
749 To make a printed document, you process a Texinfo source file with the 749 To make a printed document, you process a Texinfo source file with the
750 @TeX{} typesetting program. This creates a DVI file that you can 750 @TeX{} typesetting program. This creates a DVI file that you can
751 typeset and print as a book or report. (Note that the Texinfo language 751 typeset and print as a book or report. (Note that the Texinfo language
752 is completely different from @TeX{}'s usual language, plain @TeX{}.) If 752 is completely different from @TeX{}'s usual language, plain @TeX{}.) If
4766 utility to insert these pointers automatically.) 4766 utility to insert these pointers automatically.)
4767 4767
4768 @cindex Previous node of Top node 4768 @cindex Previous node of Top node
4769 Do not define the `Previous' node of the Top node to be @samp{(dir)}, as 4769 Do not define the `Previous' node of the Top node to be @samp{(dir)}, as
4770 it causes confusing behavior for users: if you are in the Top node and 4770 it causes confusing behavior for users: if you are in the Top node and
4771 hit @key{DEL} to go backwards, you wind up in the middle of some other 4771 hits @key{DEL} to go backwards, you wind up in the middle of the
4772 entry in the @file{dir} file, which has nothing to do with what you were 4772 some other entry in the @file{dir} file, which has nothing to do with
4773 reading. 4773 what you were reading.
4774 4774
4775 @xref{Install an Info File}, for more information about installing 4775 @xref{Install an Info File}, for more information about installing
4776 an Info file in the @file{info} directory. 4776 an Info file in the @file{info} directory.
4777 4777
4778 4778
5156 @@end menu 5156 @@end menu
5157 @end group 5157 @end group
5158 @end example 5158 @end example
5159 5159
5160 For example, to refer directly to the @samp{Outlining} and 5160 For example, to refer directly to the @samp{Outlining} and
5161 @samp{Rebinding} nodes in the @cite{XEmacs User's Manual}, you would 5161 @samp{Rebinding} nodes in the @cite{Emacs Manual}, you would write a
5162 write a menu like this:@refill 5162 menu like this:@refill
5163 5163
5164 @example 5164 @example
5165 @group 5165 @group
5166 @@menu 5166 @@menu
5167 * Outlining: (xemacs)Outline Mode. The major mode for 5167 * Outlining: (emacs)Outline Mode. The major mode for
5168 editing outlines. 5168 editing outlines.
5169 * Rebinding: (xemacs)Rebinding. How to redefine the 5169 * Rebinding: (emacs)Rebinding. How to redefine the
5170 meaning of a key. 5170 meaning of a key.
5171 @@end menu 5171 @@end menu
5172 @end group 5172 @end group
5173 @end example 5173 @end example
5174 5174
5175 If you do not list the node name, but only name the file, then Info 5175 If you do not list the node name, but only name the file, then Info
7446 @ifclear smallbook 7446 @ifclear smallbook
7447 @display 7447 @display
7448 @tex 7448 @tex
7449 % Remove extra vskip; this is a kludge to counter the effect of display 7449 % Remove extra vskip; this is a kludge to counter the effect of display
7450 \vskip-3\baselineskip 7450 \vskip-3\baselineskip
7451 {\ninett
7452 \dots{} to make sure that you have the freedom to
7453 distribute copies of free software (and charge for
7454 this service if you wish), that you receive source
7455 code or can get it if you want it, that you can
7456 change the software or use pieces of it in new free
7457 programs; and that you know you can do these things.}
7451 @end tex 7458 @end tex
7452 @end display 7459 @end display
7453 @end ifclear 7460 @end ifclear
7454 @end iftex 7461 @end iftex
7455 @ifset smallbook 7462 @ifset smallbook
8224 with @code{@@item}, and separate the column entries with @code{@@tab}. 8231 with @code{@@item}, and separate the column entries with @code{@@tab}.
8225 Line breaks are not special within the table body, and you may break 8232 Line breaks are not special within the table body, and you may break
8226 input lines in your source file as necessary. 8233 input lines in your source file as necessary.
8227 8234
8228 Here is a complete example of a multi-column table (the text is from 8235 Here is a complete example of a multi-column table (the text is from
8229 @cite{The XEmacs Users' Manual}, @pxref{Split Window,, Splitting Windows, 8236 @cite{The GNU Emacs Manual}, @pxref{Split Window,, Splitting Windows,
8230 xemacs, XEmacs User's Manual}): 8237 xemacs, XEmacs User's Manual}):
8231 8238
8232 @example 8239 @example
8233 @@multitable @@columnfractions .15 .45 .4 8240 @@multitable @@columnfractions .15 .45 .4
8234 @@item Key @@tab Command @@tab Description 8241 @@item Key @@tab Command @@tab Description
14197 @item @@need @var{n} 14204 @item @@need @var{n}
14198 Start a new page in a printed manual if fewer than @var{n} mils 14205 Start a new page in a printed manual if fewer than @var{n} mils
14199 (thousandths of an inch) remain on the current page. @xref{need, , 14206 (thousandths of an inch) remain on the current page. @xref{need, ,
14200 @code{@@need}}.@refill 14207 @code{@@need}}.@refill
14201 14208
14202 @item @@node @var{name}, @var{next}, @var{previous}, @var{up} 14209 @item @@node @var{name, next, previous, up}
14203 Define the beginning of a new node in Info, and serve as a locator for 14210 Define the beginning of a new node in Info, and serve as a locator for
14204 references for @TeX{}. @xref{node, , @code{@@node}}.@refill 14211 references for @TeX{}. @xref{node, , @code{@@node}}.@refill
14205 14212
14206 @item @@noindent 14213 @item @@noindent
14207 Prevent text from being indented as if it were a new paragraph. 14214 Prevent text from being indented as if it were a new paragraph.