home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / info / texinfo.info-1 < prev    next >
Encoding:
GNU Info File  |  1996-10-12  |  49.6 KB  |  1,130 lines
  1. This is Info file texinfo.info, produced by Makeinfo-1.64 from the
  2. input file /ade-src/fsf/texinfo/texinfo.texi.
  3.  
  4.   This file documents Texinfo, a documentation system that uses a single
  5. source file to produce both on-line information and a printed manual.
  6.  
  7.   Copyright (C) 1988, 1990, 1991, 1992, 1993, 1995 Free Software
  8. Foundation, Inc.
  9.  
  10.   This is the second edition of the Texinfo documentation,
  11. and is consistent with version 2 of `texinfo.tex'.
  12.  
  13.   Permission is granted to make and distribute verbatim copies of this
  14. manual provided the copyright notice and this permission notice are
  15. preserved on all copies.
  16.  
  17.   Permission is granted to copy and distribute modified versions of this
  18. manual under the conditions for verbatim copying, provided that the
  19. entire resulting derived work is distributed under the terms of a
  20. permission notice identical to this one.
  21.  
  22.   Permission is granted to copy and distribute translations of this
  23. manual into another language, under the above conditions for modified
  24. versions, except that this permission notice may be stated in a
  25. translation approved by the Free Software Foundation.
  26.  
  27. 
  28. File: texinfo.info,  Node: Top,  Next: Copying,  Prev: (dir),  Up: (dir)
  29.  
  30. Texinfo
  31. *******
  32.  
  33.   Texinfo is a documentation system that uses a single source file to
  34. produce both on-line information and printed output.
  35.  
  36.   The first part of this master menu lists the major nodes in this Info
  37. document, including the @-command and concept indices.  The rest of the
  38. menu lists all the lower level nodes in the document.
  39.  
  40.   This is Edition 2.21 of the Texinfo documentation, 7 June 1995, for
  41. Texinfo Version Three.
  42.  
  43. * Menu:
  44.  
  45. * Copying::                     Your rights.
  46. * Overview::                    Texinfo in brief.
  47. * Texinfo Mode::                How to use Texinfo mode.
  48. * Beginning a File::            What is at the beginning of a Texinfo file?
  49. * Ending a File::               What is at the end of a Texinfo file?
  50. * Structuring::                 How to create chapters, sections, subsections,
  51.                                   appendices, and other parts.
  52. * Nodes::                       How to write nodes.
  53. * Menus::                       How to write menus.
  54. * Cross References::            How to write cross references.
  55. * Marking Text::                How to mark words and phrases as code,
  56.                                   keyboard input, meta-syntactic
  57.                                   variables, and the like.
  58. * Quotations and Examples::     How to write quotations, examples, etc.
  59. * Lists and Tables::            How to write lists and tables.
  60. * Indices::                     How to create indices.
  61. * Insertions::                  How to insert @-signs, braces, etc.
  62. * Glyphs::                      How to indicate results of evaluation,
  63.                                   expansion of macros, errors, etc.
  64. * Breaks::                      How to force and prevent line and page breaks.
  65. * Definition Commands::         How to describe functions and the like
  66.                                   in a uniform manner.
  67. * Footnotes::                   How to write footnotes.
  68. * Conditionals::                How to specify text for either TeX or Info.
  69. * Format/Print Hardcopy::       How to convert a Texinfo file to a file
  70.                                   for printing and how to print that file.
  71. * Create an Info File::         Convert a Texinfo file into an Info file.
  72. * Install an Info File::        Make an Info file accessible to users.
  73. * Command List::                All the Texinfo @-commands.
  74. * Tips::                        Hints on how to write a Texinfo document.
  75. * Sample Texinfo File::         A sample Texinfo file to look at.
  76. * Sample Permissions::          Tell readers they have the right to copy
  77.                                   and distribute.
  78. * Include Files::               How to incorporate other Texinfo files.
  79. * Headings::                    How to write page headings and footings.
  80. * Catching Mistakes::           How to find formatting mistakes.
  81. * Refilling Paragraphs::        All about paragraph refilling.
  82. * Command Syntax::              A description of @-Command syntax.
  83. * Obtaining TeX::               How to Obtain TeX.
  84. * New Features::                Texinfo second edition features.
  85. * Command and Variable Index::  A menu containing commands and variables.
  86. * Concept Index::               A menu covering many topics.
  87.  
  88.  -- The Detailed Node Listing --
  89.  
  90. Overview of Texinfo
  91.  
  92. * Using Texinfo::               Create a conventional printed book
  93.                                   or an Info file.
  94. * Info Files::                  What is an Info file?
  95. * Printed Books::               Characteristics of a printed book or manual.
  96. * Formatting Commands::         @-commands are used for formatting.
  97. * Conventions::                 General rules for writing a Texinfo file.
  98. * Comments::                    How to write comments and mark regions that
  99.                                   the formatting commands will ignore.
  100. * Minimum::                     What a Texinfo file must have.
  101. * Six Parts::                   Usually, a Texinfo file has six parts.
  102. * Short Sample::                A short sample Texinfo file.
  103. * Acknowledgements::
  104.  
  105. Using Texinfo Mode
  106.  
  107. * Texinfo Mode Overview::       How Texinfo mode can help you.
  108. * Emacs Editing::               Texinfo mode adds to GNU Emacs' general
  109.                                   purpose editing features.
  110. * Inserting::                   How to insert frequently used @-commands.
  111. * Showing the Structure::       How to show the structure of a file.
  112. * Updating Nodes and Menus::    How to update or create new nodes and menus.
  113. * Info Formatting::             How to format for Info.
  114. * Printing::                    How to format and print part or all of a file.
  115. * Texinfo Mode Summary::        Summary of all the Texinfo mode commands.
  116.  
  117. Updating Nodes and Menus
  118.  
  119. * Updating Commands::           Five major updating commands.
  120. * Updating Requirements::       How to structure a Texinfo file for
  121.                                   using the updating command.
  122. * Other Updating Commands::     How to indent descriptions, insert
  123.                                   missing nodes lines, and update
  124.                                   nodes in sequence.
  125.  
  126. Beginning a Texinfo File
  127.  
  128. * Four Parts::                  Four parts begin a Texinfo file.
  129. * Sample Beginning::            Here is a sample beginning for a Texinfo file.
  130. * Header::                      The very beginning of a Texinfo file.
  131. * Info Summary and Permissions::  Summary and copying permissions for Info.
  132. * Titlepage & Copyright Page::  Creating the title and copyright pages.
  133. * The Top Node::                Creating the `Top' node and master menu.
  134. * Software Copying Permissions::  Ensure that you and others continue to
  135.                                   have the right to use and share software.
  136.  
  137. The Texinfo File Header
  138.  
  139. * First Line::                  The first line of a Texinfo file.
  140. * Start of Header::             Formatting a region requires this.
  141. * setfilename::                 Tell Info the name of the Info file.
  142. * settitle::                    Create a title for the printed work.
  143. * setchapternewpage::           Start chapters on right-hand pages.
  144. * paragraphindent::             An option to specify paragraph indentation.
  145. * End of Header::               Formatting a region requires this.
  146.  
  147. The Title and Copyright Pages
  148.  
  149. * titlepage::                   Create a title for the printed document.
  150. * titlefont center sp::         The `@titlefont', `@center',
  151.                                   and `@sp' commands.
  152. * title subtitle author::       The `@title', `@subtitle',
  153.                                   and `@author' commands.
  154. * Copyright & Permissions::     How to write the copyright notice and
  155.                                   include copying permissions.
  156. * end titlepage::               Turn on page headings after the title and
  157.                                   copyright pages.
  158. * headings on off::             An option for turning headings on and off
  159.                                   and double or single sided printing.
  160.  
  161. The `Top' Node and Master Menu
  162.  
  163. * Title of Top Node::           Sketch what the file is about.
  164. * Master Menu Parts::           A master menu has three or more parts.
  165.  
  166. Ending a Texinfo File
  167.  
  168. * Printing Indices & Menus::    How to print an index in hardcopy and
  169.                                   generate index menus in Info.
  170. * Contents::                    How to create a table of contents.
  171. * File End::                    How to mark the end of a file.
  172.  
  173. Chapter Structuring
  174.  
  175. * Tree Structuring::            A manual is like an upside down tree ...
  176. * Structuring Command Types::   How to divide a manual into parts.
  177. * makeinfo top::                The `@top' command, part of the `Top' node.
  178. * chapter::
  179. * unnumbered & appendix::
  180. * majorheading & chapheading::
  181. * section::
  182. * unnumberedsec appendixsec heading::
  183. * subsection::
  184. * unnumberedsubsec appendixsubsec subheading::
  185. * subsubsection::               Commands for the lowest level sections.
  186. * Raise/lower sections::        How to change commands' hierarchical level.
  187.  
  188. Nodes
  189.  
  190. * Two Paths::                   Different commands to structure
  191.                                   Info output and printed output.
  192. * Node Menu Illustration::      A diagram, and sample nodes and menus.
  193. * node::                        How to write a node, in detail.
  194. * makeinfo Pointer Creation::   How to create node pointers with `makeinfo'.
  195.  
  196. The `@node' Command
  197.  
  198. * Node Names::                  How to choose node and pointer names.
  199. * Writing a Node::              How to write an `@node' line.
  200. * Node Line Tips::              Keep names short.
  201. * Node Line Requirements::      Keep names unique, without @-commands.
  202. * First Node::                  How to write a `Top' node.
  203. * makeinfo top command::        How to use the `@top' command.
  204. * Top Node Summary::            Write a brief description for readers.
  205.  
  206. Menus
  207.  
  208. * Menu Location::               Put a menu in a short node.
  209. * Writing a Menu::              What is a menu?
  210. * Menu Parts::                  A menu entry has three parts.
  211. * Less Cluttered Menu Entry::   Two part menu entry.
  212. * Menu Example::                Two and three part menu entries.
  213. * Other Info Files::            How to refer to a different Info file.
  214.  
  215. Cross References
  216.  
  217. * References::                  What cross references are for.
  218. * Cross Reference Commands::    A summary of the different commands.
  219. * Cross Reference Parts::       A cross reference has several parts.
  220. * xref::                        Begin a reference with `See' ...
  221. * Top Node Naming::             How to refer to the beginning of another file.
  222. * ref::                         A reference for the last part of a sentence.
  223. * pxref::                       How to write a parenthetical cross reference.
  224. * inforef::                     How to refer to an Info-only file.
  225.  
  226. `@xref'
  227.  
  228. * Reference Syntax::            What a reference looks like and requires.
  229. * One Argument::                `@xref' with one argument.
  230. * Two Arguments::               `@xref' with two arguments.
  231. * Three Arguments::             `@xref' with three arguments.
  232. * Four and Five Arguments::     `@xref' with four and five arguments.
  233.  
  234. Marking Words and Phrases
  235.  
  236. * Indicating::                  How to indicate definitions, files, etc.
  237. * Emphasis::                    How to emphasize text.
  238.  
  239. Indicating Definitions, Commands, etc.
  240.  
  241. * Useful Highlighting::         Highlighting provides useful information.
  242. * code::                        How to indicate code.
  243. * kbd::                         How to show keyboard input.
  244. * key::                         How to specify keys.
  245. * samp::                        How to show a literal sequence of characters.
  246. * var::                         How to indicate a metasyntactic variable.
  247. * file::                        How to indicate the name of a file.
  248. * dfn::                         How to specify a definition.
  249. * cite::                        How to refer to a book that is not in Info.
  250.  
  251. Emphasizing Text
  252.  
  253. * emph & strong::               How to emphasize text in Texinfo.
  254. * Smallcaps::                   How to use the small caps font.
  255. * Fonts::                       Various font commands for printed output.
  256. * Customized Highlighting::     How to define highlighting commands.
  257.  
  258. Quotations and Examples
  259.  
  260. * Block Enclosing Commands::    Use different constructs for
  261.                                   different purposes.
  262. * quotation::                   How to write a quotation.
  263. * example::                     How to write an example in a fixed-width font.
  264. * noindent::                    How to prevent paragraph indentation.
  265. * Lisp Example::                How to illustrate Lisp code.
  266. * smallexample & smalllisp::    Forms for the `@smallbook' option.
  267. * display::                     How to write an example in the current font.
  268. * format::                      How to write an example that does not narrow
  269.                                   the margins.
  270. * exdent::                      How to undo the indentation of a line.
  271. * flushleft & flushright::      How to push text flushleft or flushright.
  272. * cartouche::                   How to draw cartouches around examples.
  273.  
  274. Making Lists and Tables
  275.  
  276. * Introducing Lists::           Texinfo formats lists for you.
  277. * itemize::                     How to construct a simple list.
  278. * enumerate::                   How to construct a numbered list.
  279. * Two-column Tables::           How to construct a two-column table.
  280.  
  281. Making a Two-column Table
  282.  
  283. * table::                       How to construct a two-column table.
  284. * ftable vtable::               How to construct a two-column table
  285.                                   with automatic indexing.
  286. * itemx::                       How to put more entries in the first column.
  287.  
  288. Creating Indices
  289.  
  290. * Index Entries::               Choose different words for index entries.
  291. * Predefined Indices::          Use different indices for different kinds
  292.                                   of entry.
  293. * Indexing Commands::           How to make an index entry.
  294. * Combining Indices::           How to combine indices.
  295. * New Indices::                 How to define your own indices.
  296.  
  297. Combining Indices
  298.  
  299. * syncodeindex::                How to merge two indices, using `@code'
  300.                                   font for the merged-from index.
  301. * synindex::                    How to merge two indices, using the
  302.                                   default font of the merged-to index.
  303.  
  304. Special Insertions
  305.  
  306. * Braces Atsigns Periods::      How to insert braces, `@' and periods.
  307. * dmn::                         How to format a dimension.
  308. * Dots Bullets::                How to insert dots and bullets.
  309. * TeX and copyright::           How to insert the TeX logo
  310.                                   and the copyright symbol.
  311. * minus::                       How to insert a minus sign.
  312. * math::                        How to format a mathematical expression.
  313.  
  314. Inserting `@', Braces, and Periods
  315.  
  316. * Inserting An Atsign::
  317. * Inserting Braces::            How to insert `{' and `}'
  318. * Controlling Spacing::         How to insert the right amount of space
  319.                                   after punctuation within a sentence.
  320.  
  321. Inserting Ellipsis, Dots, and Bullets
  322.  
  323. * dots::                        How to insert dots ...
  324. * bullet::                      How to insert a bullet.
  325.  
  326. Inserting TeX and the Copyright Symbol
  327.  
  328. * tex::                         How to insert the TeX logo.
  329. * copyright symbol::            How to use `@copyright'{}.
  330.  
  331. Glyphs for Examples
  332.  
  333. * Glyphs Summary::
  334. * result::                      How to show the result of expression.
  335. * expansion::                   How to indicate an expansion.
  336. * Print Glyph::                 How to indicate printed output.
  337. * Error Glyph::                 How to indicate an error message.
  338. * Equivalence::                 How to indicate equivalence.
  339. * Point Glyph::                 How to indicate the location of point.
  340.  
  341. Making and Preventing Breaks
  342.  
  343. * Break Commands::              Cause and prevent splits.
  344. * Line Breaks::                 How to force a single line to use two lines.
  345. * w::                           How to prevent unwanted line breaks.
  346. * sp::                          How to insert blank lines.
  347. * page::                        How to force the start of a new page.
  348. * group::                       How to prevent unwanted page breaks.
  349. * need::                        Another way to prevent unwanted page breaks.
  350.  
  351. Definition Commands
  352.  
  353. * Def Cmd Template::            How to structure a description using a
  354.                                   definition command.
  355. * Optional Arguments::          How to handle optional and repeated arguments.
  356. * deffnx::                      How to group two or more `first' lines.
  357. * Def Cmds in Detail::          All the definition commands.
  358. * Def Cmd Conventions::         Conventions for writing definitions.
  359. * Sample Function Definition::
  360.  
  361. The Definition Commands
  362.  
  363. * Functions Commands::          Commands for functions and similar entities.
  364. * Variables Commands::          Commands for variables and similar entities.
  365. * Typed Functions::             Commands for functions in typed languages.
  366. * Typed Variables::             Commands for variables in typed languages.
  367. * Abstract Objects::            Commands for object-oriented programming.
  368. * Data Types::                  The definition command for data types.
  369.  
  370. Footnotes
  371.  
  372. * Footnote Commands::           How to write a footnote in Texinfo.
  373. * Footnote Styles::             Controlling how footnotes appear in Info.
  374.  
  375. Conditionally Visible Text
  376.  
  377. * Conditional Commands::        How to specify text for Info or TeX.
  378. * Using Ordinary TeX Commands::  You can use any and all TeX commands.
  379. * set clear value::             How to designate which text to format (for
  380.                                   both Info and TeX); and how to set a
  381.                                   flag to a string that you can insert.
  382.  
  383. `@set', `@clear', and `@value'
  384.  
  385. * ifset ifclear::               Format a region if a flag is set.
  386. * value::                       Replace a flag with a string.
  387. * value Example::               An easy way to update edition information.
  388.  
  389. Format and Print Hardcopy
  390.  
  391. * Use TeX::                     Use TeX to format for hardcopy.
  392. * Format with tex/texindex::    How to format in a shell.
  393. * Format with texi2dvi::        A simpler way to use the shell.
  394. * Print with lpr::              How to print.
  395. * Within Emacs::                How to format and print from an Emacs shell.
  396. * Texinfo Mode Printing::       How to format and print in Texinfo mode.
  397. * Compile-Command::             How to print using Emacs's compile command.
  398. * Requirements Summary::        TeX formatting requirements summary.
  399. * Preparing for TeX::           What you need to do to use TeX.
  400. * Overfull hboxes::             What are and what to do with overfull hboxes.
  401. * smallbook::                   How to print small format books and manuals.
  402. * A4 Paper::                    How to print on European A4 paper.
  403. * Cropmarks and Magnification::  How to print marks to indicate the size
  404.                                 of pages and how to print scaled up output.
  405.  
  406. Creating an Info File
  407.  
  408. * makeinfo advantages::         `makeinfo' provides better error checking.
  409. * Invoking makeinfo::           How to run `makeinfo' from a shell.
  410. * makeinfo options::            Specify fill-column and other options.
  411. * Pointer Validation::          How to check that pointers point somewhere.
  412. * makeinfo in Emacs::           How to run `makeinfo' from Emacs.
  413. * texinfo-format commands::     Two Info formatting commands written
  414.                                   in Emacs Lisp are an alternative
  415.                                   to `makeinfo'.
  416. * Batch Formatting::            How to format for Info in Emacs Batch mode.
  417. * Tag and Split Files::         How tagged and split files help Info
  418.                                   to run better.
  419.  
  420. Installing an Info File
  421.  
  422. * Directory file::              The top level menu for all Info files.
  423. * New Info File::               Listing a new info file.
  424. * Other Info Directories::      How to specify Info files that are
  425.                                   located in other directories.
  426.  
  427. Sample Permissions
  428.  
  429. * Inserting Permissions::       How to put permissions in your document.
  430. * ifinfo Permissions::          Sample `ifinfo' copying permissions.
  431. * Titlepage Permissions::       Sample Titlepage copying permissions.
  432.  
  433. Include Files
  434.  
  435. * Using Include Files::         How to use the `@include' command.
  436. * texinfo-multiple-files-update::  How to create and update nodes and
  437.                                   menus when using included files.
  438. * Include File Requirements::   What `texinfo-multiple-files-update' expects.
  439. * Sample Include File::         A sample outer file with included files
  440.                                   within it; and a sample included file.
  441. * Include Files Evolution::     How use of the `@include' command
  442.                                   has changed over time.
  443.  
  444. Page Headings
  445.  
  446. * Headings Introduced::         Conventions for using page headings.
  447. * Heading Format::              Standard page heading formats.
  448. * Heading Choice::              How to specify the type of page heading.
  449. * Custom Headings::             How to create your own headings and footings.
  450.  
  451. Formatting Mistakes
  452.  
  453. * makeinfo preferred::          `makeinfo' finds errors.
  454. * Debugging with Info::         How to catch errors with Info formatting.
  455. * Debugging with TeX::          How to catch errors with TeX formatting.
  456. * Using texinfo-show-structure::  How to use `texinfo-show-structure'.
  457. * Using occur::                 How to list all lines containing a pattern.
  458. * Running Info-Validate::       How to find badly referenced nodes.
  459.  
  460. Finding Badly Referenced Nodes
  461.  
  462. * Using Info-validate::         How to run `Info-validate'.
  463. * Unsplit::                     How to create an unsplit file.
  464. * Tagifying::                   How to tagify a file.
  465. * Splitting::                   How to split a file manually.
  466.  
  467. Second Edition Features
  468.  
  469. * New Texinfo Mode Commands::   The updating commands are especially useful.
  470. * New Commands::                Many newly described @-commands.
  471.  
  472. 
  473. File: texinfo.info,  Node: Copying,  Next: Overview,  Prev: Top,  Up: Top
  474.  
  475. Texinfo Copying Conditions
  476. **************************
  477.  
  478.   The programs currently being distributed that relate to Texinfo
  479. include portions of GNU Emacs, plus other separate programs (including
  480. `makeinfo', `info', `texindex', and `texinfo.tex').  These programs are
  481. "free"; this means that everyone is free to use them and free to
  482. redistribute them on a free basis.  The Texinfo-related programs are
  483. not in the public domain; they are copyrighted and there are
  484. restrictions on their distribution, but these restrictions are designed
  485. to permit everything that a good cooperating citizen would want to do.
  486. What is not allowed is to try to prevent others from further sharing
  487. any version of these programs that they might get from you.
  488.  
  489.   Specifically, we want to make sure that you have the right to give
  490. away copies of the programs that relate to Texinfo, that you receive
  491. source code or else can get it if you want it, that you can change these
  492. programs or use pieces of them in new free programs, and that you know
  493. you can do these things.
  494.  
  495.   To make sure that everyone has such rights, we have to forbid you to
  496. deprive anyone else of these rights.  For example, if you distribute
  497. copies of the Texinfo related programs, you must give the recipients all
  498. the rights that you have.  You must make sure that they, too, receive or
  499. can get the source code.  And you must tell them their rights.
  500.  
  501.   Also, for our own protection, we must make certain that everyone finds
  502. out that there is no warranty for the programs that relate to Texinfo.
  503. If these programs are modified by someone else and passed on, we want
  504. their recipients to know that what they have is not what we distributed,
  505. so that any problems introduced by others will not reflect on our
  506. reputation.
  507.  
  508.   The precise conditions of the licenses for the programs currently
  509. being distributed that relate to Texinfo are found in the General Public
  510. Licenses that accompany them.
  511.  
  512. 
  513. File: texinfo.info,  Node: Overview,  Next: Texinfo Mode,  Prev: Copying,  Up: Top
  514.  
  515. Overview of Texinfo
  516. *******************
  517.  
  518.   "Texinfo"(1) (*note Overview-Footnotes::) is a documentation system
  519. that uses a single source file to produce both on-line information and
  520. printed output.  This means that instead of writing two different
  521. documents, one for the on-line help or other on-line information and
  522. the other for a typeset manual or other printed work, you need write
  523. only one document.  When the work is revised, you need revise only one
  524. document.  (You can read the on-line information, known as an "Info
  525. file", with an Info documentation-reading program.)
  526.  
  527. * Menu:
  528.  
  529. * Using Texinfo::               Create a conventional printed book
  530.                                   or an Info file.
  531. * Info Files::                  What is an Info file?
  532. * Printed Books::               Characteristics of a printed book or manual.
  533. * Formatting Commands::         @-commands are used for formatting.
  534. * Conventions::                 General rules for writing a Texinfo file.
  535. * Comments::                    How to write comments and mark regions that
  536.                                   the formatting commands will ignore.
  537. * Minimum::                     What a Texinfo file must have.
  538. * Six Parts::                   Usually, a Texinfo file has six parts.
  539. * Short Sample::                A short sample Texinfo file.
  540. * Acknowledgements::
  541.  
  542. 
  543. File: texinfo.info,  Node: Overview-Footnotes,  Up: Overview
  544.  
  545.   (1)  Note that the first syllable of "Texinfo" is pronounced like
  546. "speck", not "hex".  This odd pronunciation is derived from, but is not
  547. the same as, the pronunciation of TeX.  In the word TeX, the `X' is
  548. actually the Greek letter "chi" rather than the English letter "ex".
  549. Pronounce TeX as if the `X' were the last sound in the name `Bach'; but
  550. pronounce Texinfo as if the `x' were a `k'.  Spell "Texinfo" with a
  551. capital "T" and write the other letters in lower case.
  552.  
  553. 
  554. File: texinfo.info,  Node: Using Texinfo,  Next: Info Files,  Prev: Overview,  Up: Overview
  555.  
  556. Using Texinfo
  557. =============
  558.  
  559.   Using Texinfo, you can create a printed document with the normal
  560. features of a book, including chapters, sections, cross references, and
  561. indices.  From the same Texinfo source file, you can create a
  562. menu-driven, on-line Info file with nodes, menus, cross references, and
  563. indices.  You can, if you wish, make the chapters and sections of the
  564. printed document correspond to the nodes of the on-line information;
  565. and you use the same cross references and indices for both the Info
  566. file and the printed work.  `The GNU Emacs Manual' is a good example of
  567. a Texinfo file, as is this manual.
  568.  
  569.   To make a printed document, you process a Texinfo source file with the
  570. TeX typesetting program.  This creates a DVI file that you can typeset
  571. and print as a book or report.  (Note that the Texinfo language is
  572. completely different from TeX's usual language, PlainTeX, which Texinfo
  573. replaces.)  If you do not have TeX, but do have `troff' or `nroff', you
  574. can use the `texi2roff' program instead.
  575.  
  576.   To make an Info file, you process a Texinfo source file with the
  577. `makeinfo' utility or Emacs's `texinfo-format-buffer' command; this
  578. creates an Info file that you can install on-line.
  579.  
  580.   TeX and `texi2roff' work with many types of printer; similarly, Info
  581. works with almost every type of computer terminal.  This power makes
  582. Texinfo a general purpose system, but brings with it a constraint,
  583. which is that a Texinfo file may contain only the customary
  584. "typewriter" characters (letters, numbers, spaces, and punctuation
  585. marks) but no special graphics.
  586.  
  587.   A Texinfo file is a plain ASCII file containing text and "@-commands"
  588. (words preceded by an `@') that tell the typesetting and formatting
  589. programs what to do.  You may edit a Texinfo file with any text editor;
  590. but it is especially convenient to use GNU Emacs since that editor has
  591. a special mode, called Texinfo mode, that provides various
  592. Texinfo-related features.  (*Note Texinfo Mode::.)
  593.  
  594.   Before writing a Texinfo source file, you should become familiar with
  595. the Info documentation reading program and learn about nodes, menus,
  596. cross references, and the rest.  (*note info: (info)Top, for more
  597. information.)
  598.  
  599.   You can use Texinfo to create both on-line help and printed manuals;
  600. moreover, Texinfo is freely redistributable.  For these reasons, Texinfo
  601. is the format in which documentation for GNU utilities and libraries is
  602. written.
  603.  
  604. 
  605. File: texinfo.info,  Node: Info Files,  Next: Printed Books,  Prev: Using Texinfo,  Up: Overview
  606.  
  607. Info files
  608. ==========
  609.  
  610.   An Info file is a Texinfo file formatted so that the Info
  611. documentation reading program can operate on it.  (`makeinfo' and
  612. `texinfo-format-buffer' are two commands that convert a Texinfo file
  613. into an Info file.)
  614.  
  615.   Info files are divided into pieces called "nodes", each of which
  616. contains the discussion of one topic.  Each node has a name, and
  617. contains both text for the user to read and pointers to other nodes,
  618. which are identified by their names.  The Info program displays one node
  619. at a time, and provides commands with which the user can move to other
  620. related nodes.
  621.  
  622.   *note info: (info)Top, for more information about using Info.
  623.  
  624.   Each node of an Info file may have any number of child nodes that
  625. describe subtopics of the node's topic.  The names of child nodes are
  626. listed in a "menu" within the parent node; this allows you to use
  627. certain Info commands to move to one of the child nodes.  Generally, an
  628. Info file is organized like a book.  If a node is at the logical level
  629. of a chapter, its child nodes are at the level of sections; likewise,
  630. the child nodes of sections are at the level of subsections.
  631.  
  632.   All the children of any one parent are linked together in a
  633. bidirectional chain of `Next' and `Previous' pointers.  The `Next'
  634. pointer provides a link to the next section, and the `Previous' pointer
  635. provides a link to the previous section.  This means that all the nodes
  636. that are at the level of sections within a chapter are linked together.
  637. Normally the order in this chain is the same as the order of the
  638. children in the parent's menu.  Each child node records the parent node
  639. name as its `Up' pointer.  The last child has no `Next' pointer, and the
  640. first child has the parent both as its `Previous' and as its `Up'
  641. pointer.(1) (*note Info Files-Footnotes::)
  642.  
  643.   The book-like structuring of an Info file into nodes that correspond
  644. to chapters, sections, and the like is a matter of convention, not a
  645. requirement.  The `Up', `Previous', and `Next' pointers of a node can
  646. point to any other nodes, and a menu can contain any other nodes.
  647. Thus, the node structure can be any directed graph.  But it is usually
  648. more comprehensible to follow a structure that corresponds to the
  649. structure of chapters and sections in a printed book or report.
  650.  
  651.   In addition to menus and to `Next', `Previous', and `Up' pointers,
  652. Info provides pointers of another kind, called references, that can be
  653. sprinkled throughout the text.  This is usually the best way to
  654. represent links that do not fit a hierarchical structure.
  655.  
  656.   Usually, you will design a document so that its nodes match the
  657. structure of chapters and sections in the printed output.  But there
  658. are times when this is not right for the material being discussed.
  659. Therefore, Texinfo uses separate commands to specify the node structure
  660. for the Info file and the section structure for the printed output.
  661.  
  662.   Generally, you enter an Info file through a node that by convention is
  663. called `Top'.  This node normally contains just a brief summary of the
  664. file's purpose, and a large menu through which the rest of the file is
  665. reached.  From this node, you can either traverse the file
  666. systematically by going from node to node, or you can go to a specific
  667. node listed in the main menu, or you can search the index menus and
  668. then go directly to the node that has the information you want.
  669.  
  670.   If you want to read through an Info file in sequence, as if it were a
  671. printed manual, you can get the whole file with the advanced Info
  672. command `g* RET'.  (*note Advanced Info commands: (info)Expert.)
  673.  
  674.   The `dir' file in the `info' directory serves as the departure point
  675. for the whole Info system.  From it, you can reach the `Top' nodes of
  676. each of the documents in a complete Info system.
  677.  
  678. 
  679. File: texinfo.info,  Node: Info Files-Footnotes,  Up: Info Files
  680.  
  681.   (1)  In some documents, the first child has no `Previous' pointer.
  682. Occasionally, the last child has the node name of the next following
  683. higher level node as its `Next' pointer.
  684.  
  685. 
  686. File: texinfo.info,  Node: Printed Books,  Next: Formatting Commands,  Prev: Info Files,  Up: Overview
  687.  
  688. Printed Books
  689. =============
  690.  
  691.   A Texinfo file can be formatted and typeset as a printed book or
  692. manual.  To do this, you need TeX, a powerful, sophisticated typesetting
  693. program written by Donald Knuth.(1) (*note Printed Books-Footnotes::)
  694.  
  695.   A Texinfo-based book is similar to any other typeset, printed work: it
  696. can have a title page, copyright page, table of contents, and preface,
  697. as well as chapters, numbered or unnumbered sections and subsections,
  698. page headers, cross references, footnotes, and indices.
  699.  
  700.   You can use Texinfo to write a book without ever having the intention
  701. of converting it into on-line information.  You can use Texinfo for
  702. writing a printed novel, and even to write a printed memo, although
  703. this latter application is not recommended since electronic mail is so
  704. much easier.
  705.  
  706.   TeX is a general purpose typesetting program.  Texinfo provides a
  707. file called `texinfo.tex' that contains information (definitions or
  708. "macros") that TeX uses when it typesets a Texinfo file.
  709. (`texinfo.tex' tells TeX how to convert the Texinfo @-commands to TeX
  710. commands, which TeX can then process to create the typeset document.)
  711. `texinfo.tex' contains the specifications for printing a document.
  712.  
  713.   Most often, documents are printed on 8.5 inch by 11 inch pages (216mm
  714. by 280mm; this is the default size), but you can also print for 7 inch
  715. by 9.25 inch pages (178mm by 235mm; the `@smallbook' size) or on
  716. European A4 size paper (`@afourpaper').  (*Note Printing "Small" Books:
  717. smallbook.  Also, see *Note Printing on A4 Paper: A4 Paper.)
  718.  
  719.   By changing the parameters in `texinfo.tex', you can change the size
  720. of the printed document.  In addition, you can change the style in
  721. which the printed document is formatted; for example, you can change the
  722. sizes and fonts used, the amount of indentation for each paragraph, the
  723. degree to which words are hyphenated, and the like.  By changing the
  724. specifications, you can make a book look dignified, old and serious, or
  725. light-hearted, young and cheery.
  726.  
  727.   TeX is freely distributable.  It is written in a dialect of Pascal
  728. called WEB and can be compiled either in Pascal or (by using a
  729. conversion program that comes with the TeX distribution) in C.  (*Note
  730. TeX Mode: (emacs)TeX Mode, for information about TeX.)
  731.  
  732.   TeX is very powerful and has a great many features.  Because a
  733. Texinfo file must be able to present information both on a
  734. character-only terminal in Info form and in a typeset book, the
  735. formatting commands that Texinfo supports are necessarily limited.
  736.  
  737.   *Note How to Obtain TeX: Obtaining TeX.
  738.  
  739. 
  740. File: texinfo.info,  Node: Printed Books-Footnotes,  Up: Printed Books
  741.  
  742.   (1)  You can also use the `texi2roff' program if you do not have TeX;
  743. since Texinfo is designed for use with TeX, `texi2roff' is not
  744. described here.  `texi2roff' is part of the standard GNU distribution.
  745.  
  746. 
  747. File: texinfo.info,  Node: Formatting Commands,  Next: Conventions,  Prev: Printed Books,  Up: Overview
  748.  
  749. @-commands
  750. ==========
  751.  
  752.   In a Texinfo file, the commands that tell TeX how to typeset the
  753. printed manual and tell `makeinfo' and `texinfo-format-buffer' how to
  754. create an Info file are preceded by `@'; they are called "@-commands".
  755. For example, `@node' is the command to indicate a node and `@chapter'
  756. is the command to indicate the start of a chapter.
  757.  
  758.      *Please note:* All the @-commands, with the exception of the
  759.      `@TeX{}' command, must be written entirely in lower case.
  760.  
  761.   The Texinfo @-commands are a strictly limited set of constructs.  The
  762. strict limits make it possible for Texinfo files to be understood both
  763. by TeX and by the code that converts them into Info files.  You can
  764. display Info files on any terminal that displays alphabetic and numeric
  765. characters.  Similarly, you can print the output generated by TeX on a
  766. wide variety of printers.
  767.  
  768.   Depending on what they do or what arguments(1) (*note Formatting
  769. Commands-Footnotes::) they take, you need to write @-commands on lines
  770. of their own or as part of sentences:
  771.  
  772.    * Write a command such as `@noindent' at the beginning of a line as
  773.      the only text on the line.  (`@noindent' prevents the beginning of
  774.      the next line from being indented as the beginning of a paragraph.)
  775.  
  776.    * Write a command such as `@chapter' at the beginning of a line
  777.      followed by the command's arguments, in this case the chapter
  778.      title, on the rest of the line.  (`@chapter' creates chapter
  779.      titles.)
  780.  
  781.    * Write a command such as `@dots{}' wherever you wish but usually
  782.      within a sentence. (`@dots{}' creates dots ...)
  783.  
  784.    * Write a command such as `@code{SAMPLE-CODE}' wherever you wish
  785.      (but usually within a sentence) with its argument, SAMPLE-CODE in
  786.      this example, between the braces.  (`@code' marks text as being
  787.      code.)
  788.  
  789.    * Write a command such as `@example' at the beginning of a line of
  790.      its own; write the body-text on following lines; and write the
  791.      matching `@end' command, `@end example' in this case, at the
  792.      beginning of a line of its own after the body-text. (`@example'
  793.      ... `@end example' indents and typesets body-text as an example.)
  794.  
  795. As a general rule, a command requires braces if it mingles among other
  796. text; but it does not need braces if it starts a line of its own.  The
  797. non-alphabetic commands, such as `@:', are exceptions to the rule; they
  798. do not need braces.
  799.  
  800.   As you gain experience with Texinfo, you will rapidly learn how to
  801. write the different commands: the different ways to write commands make
  802. it easier to write and read Texinfo files than if all commands followed
  803. exactly the same syntax.  (For details about @-command syntax, see
  804. *Note @-Command Syntax: Command Syntax.)
  805.  
  806. 
  807. File: texinfo.info,  Node: Formatting Commands-Footnotes,  Up: Formatting Commands
  808.  
  809.   (1)  The word "argument" comes from the way it is used in mathematics
  810. and does not refer to a disputation between two people; it refers to the
  811. information presented to the command.  According to the `Oxford English
  812. Dictionary', the word derives from the Latin for "to make clear,
  813. prove"; thus it came to mean `the evidence offered as proof', which is
  814. to say, `the information offered', which led to its mathematical
  815. meaning.  In its other thread of derivation, the word came to mean `to
  816. assert in a manner against which others may make counter assertions',
  817. which led to the meaning of `argument' as a disputation.
  818.  
  819. 
  820. File: texinfo.info,  Node: Conventions,  Next: Comments,  Prev: Formatting Commands,  Up: Overview
  821.  
  822. General Syntactic Conventions
  823. =============================
  824.  
  825.   All ASCII printing characters except `@', `{' and `}' can appear in a
  826. Texinfo file and stand for themselves.  `@' is the escape character
  827. which introduces commands.  `{' and `}' should be used only to surround
  828. arguments to certain commands.  To put one of these special characters
  829. into the document, put an `@' character in front of it, like this:
  830. `@@', `@{', and `@}'.
  831.  
  832.   It is customary in TeX to use doubled single-quote characters to
  833. begin and end quotations: ` ` and ' ' (but without a space between the
  834. two single-quote characters).  This convention should be followed in
  835. Texinfo files.  TeX converts doubled single-quote characters to left-
  836. and right-hand doubled quotation marks and Info converts doubled
  837. single-quote characters to ASCII double-quotes: ` ` and ' ' to " .
  838.  
  839.   Use three hyphens in a row, `---', for a dash--like this.  In TeX, a
  840. single or even a double hyphen produces a printed dash that is shorter
  841. than the usual typeset dash. Info reduces three hyphens to two for
  842. display on the screen.
  843.  
  844.   To prevent a paragraph from being indented in the printed manual, put
  845. the command `@noindent' on a line by itself before the paragraph.
  846.  
  847.   If you mark off a region of the Texinfo file with the `@iftex' and
  848. `@end iftex' commands, that region will appear only in the printed
  849. copy; in that region, you can use certain commands borrowed from
  850. PlainTeX that you cannot use in Info.  Likewise, if you mark off a
  851. region with the `@ifinfo' and `@end ifinfo' commands, that region will
  852. appear only in the Info file; in that region, you can use Info commands
  853. that you cannot use in TeX.  (*Note Conditionals::.)
  854.  
  855.      *Caution:* Do not use tabs in a Texinfo file!  TeX uses
  856.      variable-width fonts, which means that it cannot predefine a tab
  857.      to work in all circumstances.  Consequently, TeX treats tabs like
  858.      single spaces, and that is not what they look like.
  859.  
  860.      To avoid this problem, Texinfo mode causes GNU Emacs to insert
  861.      multiple spaces when you press the TAB key.
  862.  
  863.      Also, you can run `untabify' in Emacs to convert tabs in a region
  864.      to multiple spaces.
  865.  
  866. 
  867. File: texinfo.info,  Node: Comments,  Next: Minimum,  Prev: Conventions,  Up: Overview
  868.  
  869. Comments
  870. ========
  871.  
  872.   You can write comments in a Texinfo file that will not appear in
  873. either the Info file or the printed manual by using the `@comment'
  874. command (which may be abbreviated to `@c').  Such comments are for the
  875. person who reads the Texinfo file.  All the text on a line that follows
  876. either `@comment' or `@c' is a comment; the rest of the line does not
  877. appear in either the Info file or the printed manual. (Often, you can
  878. write the `@comment' or `@c' in the middle of a line, and only the text
  879. that follows after the `@comment' or `@c' command does not appear; but
  880. some commands, such as `@settitle' and `@setfilename', work on a whole
  881. line.  You cannot use `@comment' or `@c' in a line beginning with such
  882. a command.)
  883.  
  884.   You can write long stretches of text that will not appear in either
  885. the Info file or the printed manual by using the `@ignore' and `@end
  886. ignore' commands.  Write each of these commands on a line of its own,
  887. starting each command at the beginning of the line.  Text between these
  888. two commands does not appear in the processed output.  You can use
  889. `@ignore' and `@end ignore' for writing comments.  Often, `@ignore' and
  890. `@end ignore' is used to enclose a part of the copying permissions that
  891. applies to the Texinfo source file of a document, but not to the Info
  892. or printed version of the document.
  893.  
  894. 
  895. File: texinfo.info,  Node: Minimum,  Next: Six Parts,  Prev: Comments,  Up: Overview
  896.  
  897. What a Texinfo File Must Have
  898. =============================
  899.  
  900.   By convention, the names of Texinfo files end with one of the
  901. extensions `.texinfo', `.texi', or `.tex'.  The longer extension is
  902. preferred since it describes more clearly to a human reader the nature
  903. of the file.  The shorter extensions are for operating systems that
  904. cannot handle long file names.
  905.  
  906.   In order to be made into a printed manual and an Info file, a Texinfo
  907. file *must* begin with lines like this:
  908.  
  909.      \input texinfo
  910.      @setfilename INFO-FILE-NAME
  911.      @settitle NAME-OF-MANUAL
  912.  
  913. The contents of the file follow this beginning, and then you *must* end
  914. a Texinfo file with a line like this:
  915.  
  916.      @bye
  917.  
  918. The `\input texinfo' line tells TeX to use the `texinfo.tex' file,
  919. which tells TeX how to translate the Texinfo @-commands into TeX
  920. typesetting commands.  (Note the use of the backslash, `\'; this is
  921. correct for TeX.)  The `@setfilename' line provides a name for the Info
  922. file and the `@settitle' line specifies a title for the page headers (or
  923. footers) of the printed manual.
  924.  
  925.   The `@bye' line at the end of the file on a line of its own tells the
  926. formatters that the file is ended and to stop formatting.
  927.  
  928.   Usually, you will not use quite such a spare format, but will include
  929. mode setting and start-of-header and end-of-header lines at the
  930. beginning of a Texinfo file, like this:
  931.  
  932.      \input texinfo   @c -*-texinfo-*-
  933.      @c %**start of header
  934.      @setfilename INFO-FILE-NAME
  935.      @settitle NAME-OF-MANUAL
  936.      @c %**end of header
  937.  
  938. In the first line, `-*-texinfo-*-' causes Emacs to switch into Texinfo
  939. mode when you edit the file.
  940.  
  941.   The `@c' lines which surround the `@setfilename' and `@settitle'
  942. lines are optional, but you need them in order to run TeX or Info on
  943. just part of the file.  (*Note Start of Header::, for more information.)
  944.  
  945.   Furthermore, you will usually provide a Texinfo file with a title
  946. page, indices, and the like.  But the minimum, which can be useful for
  947. short documents, is just the three lines at the beginning and the one
  948. line at the end.
  949.  
  950. 
  951. File: texinfo.info,  Node: Six Parts,  Next: Short Sample,  Prev: Minimum,  Up: Overview
  952.  
  953. Six Parts of a Texinfo File
  954. ===========================
  955.  
  956.   Generally, a Texinfo file contains more than the minimal beginning
  957. and end--it usually contains six parts:
  958.  
  959. 1. Header
  960.      The "Header" names the file, tells TeX which definitions' file to
  961.      use, and performs other "housekeeping" tasks.
  962.  
  963. 2. Summary Description and Copyright
  964.      The "Summary Description and Copyright" segment describes the
  965.      document and contains the copyright notice and copying permissions
  966.      for the Info file.  The segment must be enclosed between `@ifinfo'
  967.      and `@end ifinfo' commands so that the formatters place it only in
  968.      the Info file.
  969.  
  970. 3. Title and Copyright
  971.      The "Title and Copyright" segment contains the title and copyright
  972.      pages and copying permissions for the printed manual.  The segment
  973.      must be enclosed between `@titlepage' and `@end titlepage'
  974.      commands.  The title and copyright page appear only in the printed
  975.      manual.
  976.  
  977. 4. `Top' Node and Master Menu
  978.      The "Master Menu" contains a complete menu of all the nodes in the
  979.      whole Info file.  It appears only in the Info file, in the `Top'
  980.      node.
  981.  
  982. 5. Body
  983.      The "Body" of the document may be structured like a traditional
  984.      book or encyclopedia or it may be free form.
  985.  
  986. 6. End
  987.      The "End" contains commands for printing indices and generating
  988.      the table of contents, and the `@bye' command on a line of its own.
  989.  
  990. 
  991. File: texinfo.info,  Node: Short Sample,  Next: Acknowledgements,  Prev: Six Parts,  Up: Overview
  992.  
  993. A Short Sample Texinfo File
  994. ===========================
  995.  
  996.   Here is a complete but very short Texinfo file, in 6 parts.  The first
  997. three parts of the file, from `\input texinfo' through to `@end
  998. titlepage', look more intimidating than they are.  Most of the material
  999. is standard boilerplate; when you write a manual, simply insert the
  1000. names for your own manual in this segment. (*Note Beginning a File::.)
  1001.  
  1002. In the following, the sample text is *indented*; comments on it are
  1003. not.  The complete file, without any comments, is shown in *Note Sample
  1004. Texinfo File::.
  1005.  
  1006. Part 1: Header
  1007. --------------
  1008.  
  1009. The header does not appear in either the Info file or the
  1010. printed output.  It sets various parameters, including the
  1011. name of the Info file and the title used in the header.
  1012.  
  1013.      \input texinfo   @c -*-texinfo-*-
  1014.      @c %**start of header
  1015.      @setfilename sample.info
  1016.      @settitle Sample Document
  1017.      @c %**end of header
  1018.      
  1019.      @setchapternewpage odd
  1020.  
  1021. Part 2: Summary Description and Copyright
  1022. -----------------------------------------
  1023.  
  1024. The summary description and copyright segment does not
  1025. appear in the printed document.
  1026.  
  1027.      @ifinfo
  1028.      This is a short example of a complete Texinfo file.
  1029.      
  1030.      Copyright @copyright{} 1990 Free Software Foundation, Inc.
  1031.      @end ifinfo
  1032.  
  1033. Part 3: Titlepage and Copyright
  1034. -------------------------------
  1035.  
  1036. The titlepage segment does not appear in the Info file.
  1037.  
  1038.      @titlepage
  1039.      @sp 10
  1040.      @comment The title is printed in a large font.
  1041.      @center @titlefont{Sample Title}
  1042.      
  1043.      @c The following two commands start the copyright page.
  1044.      @page
  1045.      @vskip 0pt plus 1filll
  1046.      Copyright @copyright{} 1990 Free Software Foundation, Inc.
  1047.      @end titlepage
  1048.  
  1049. Part 4: `Top' Node and Master Menu
  1050. ----------------------------------
  1051.  
  1052. The `Top' node contains the master menu for the Info file.
  1053. Since a printed manual uses a table of contents rather than
  1054. a menu, the master menu appears only in the Info file.
  1055.  
  1056.      @node    Top,       First Chapter, (dir),    (dir)
  1057.      @comment node-name, next,          previous, up
  1058.  
  1059.      @menu
  1060.      * First Chapter::    The first chapter is the
  1061.                           only chapter in this sample.
  1062.      * Concept Index::    This index has two entries.
  1063.      @end menu
  1064.  
  1065. Part 5:  The Body of the Document
  1066. ---------------------------------
  1067.  
  1068. The body segment contains all the text of the document, but not the
  1069. indices or table of contents.  This example illustrates a node and a
  1070. chapter containing an enumerated list.
  1071.  
  1072.      @node    First Chapter, Concept Index, Top,      Top
  1073.      @comment node-name,     next,          previous, up
  1074.      @chapter First Chapter
  1075.      @cindex Sample index entry
  1076.      
  1077.      This is the contents of the first chapter.
  1078.      @cindex Another sample index entry
  1079.      
  1080.      Here is a numbered list.
  1081.      
  1082.      @enumerate
  1083.      @item
  1084.      This is the first item.
  1085.      
  1086.      @item
  1087.      This is the second item.
  1088.      @end enumerate
  1089.      
  1090.      The @code{makeinfo} and @code{texinfo-format-buffer}
  1091.      commands transform a Texinfo file such as this into
  1092.      an Info file; and @TeX{} typesets it for a printed
  1093.      manual.
  1094.  
  1095. Part 6: The End of the Document
  1096. -------------------------------
  1097.  
  1098. The end segment contains commands both for generating an index in a node
  1099. and unnumbered chapter of its own and for generating the table of
  1100. contents; and it contains the `@bye' command that marks the end of the
  1101. document.
  1102.  
  1103.      @node    Concept Index,    ,  First Chapter, Top
  1104.      @comment node-name,    next,  previous,      up
  1105.      @unnumbered Concept Index
  1106.      
  1107.      @printindex cp
  1108.      
  1109.      @contents
  1110.      @bye
  1111.  
  1112. The Results
  1113. -----------
  1114.  
  1115.   Here is what the contents of the first chapter of the sample look
  1116. like:
  1117.  
  1118.      This is the contents of the first chapter.
  1119.  
  1120.      Here is a numbered list.
  1121.  
  1122.        1. This is the first item.
  1123.  
  1124.        2. This is the second item.
  1125.  
  1126.      The `makeinfo' and `texinfo-format-buffer' commands transform a
  1127.      Texinfo file such as this into an Info file; and TeX typesets it
  1128.      for a printed manual.
  1129.  
  1130.