home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / prgramer / unix / info / texinfo.i10 (.txt) < prev    next >
GNU Info File  |  1993-06-12  |  44KB  |  863 lines
  1. This is Info file texinfo, produced by Makeinfo-1.47 from the input
  2. file texinfo2.tex.
  3.    This file documents Texinfo, a documentation system that uses a
  4. single source file to produce both on-line information and a printed
  5. manual.
  6.    Copyright (C) 1988, 1990, 1991, 1992 Free Software Foundation, Inc.
  7.    This is the second edition of the Texinfo documentation,
  8. and is consistent with version 2 of `texinfo.tex'.
  9.    Permission is granted to make and distribute verbatim copies of this
  10. manual provided the copyright notice and this permission notice are
  11. preserved on all copies.
  12.    Permission is granted to copy and distribute modified versions of
  13. this manual under the conditions for verbatim copying, provided that
  14. the entire resulting derived work is distributed under the terms of a
  15. permission notice identical to this one.
  16.    Permission is granted to copy and distribute translations of this
  17. manual into another language, under the above conditions for modified
  18. versions, except that this permission notice may be stated in a
  19. translation approved by the Foundation.
  20. File: texinfo,  Node: New Texinfo Mode Commands,  Next: New Commands,  Up: New Features
  21. New Texinfo Mode Commands
  22. =========================
  23.    Texinfo mode provides commands and features especially designed for
  24. working with Texinfo files.  More than 20 new commands have been added,
  25. including commands for automatically creating and updating both nodes
  26. and menus.  This is a tedious task when done by hand.
  27.    The keybindings are intended to be somewhat mnemonic.
  28. Update Pointers
  29. ---------------
  30. Create or update `Next', `Previous', and `Up' node pointers.
  31. *Note Updating Nodes and Menus::.
  32.      C-c C-u C-n     Update a node.
  33.      C-c C-u C-e     Update every node in the buffer.
  34. Update Menus
  35. ------------
  36. Create or update menus.
  37. *Note Updating Nodes and Menus::.
  38.      C-c C-u m       Create or update a master menu.
  39.                      With `C-u' as a prefix argument,
  40.                      first create or update all nodes
  41.                      and regular menus.
  42.      
  43.      C-c C-u C-m     Make or update a menu.
  44.      
  45.      C-c C-u C-a     Make or update all the menus in a buffer.
  46.                      With `C-u' as a prefix argument,
  47.                      first update all the nodes.
  48. Format for Info
  49. ---------------
  50. Provide keybindings both for the Info formatting commands that are
  51. written in Emacs Lisp and for `makeinfo' which is written in C.
  52. *Note Info Formatting::.
  53. Use the Emacs lisp `texinfo-format...' commands:
  54.      C-c C-e C-r     Format the region.
  55.      C-c C-e C-b     Format the buffer.
  56. Use `makeinfo':
  57.      C-c C-m C-r     Format the region.
  58.      C-c C-m C-b     Format the buffer.
  59.      C-c C-m C-l     Recenter the `makeinfo' output buffer.
  60.      C-c C-m C-k     Kill the `makeinfo' formatting job.
  61. Typeset and Print
  62. -----------------
  63. Typeset and print Texinfo documents from within Emacs.
  64. *Note Printing::.
  65.      C-c C-t C-r     Run TeX on the region.
  66.      C-c C-t C-b     Run TeX on the buffer.
  67.      C-c C-t C-i     Run `texindex'.
  68.      C-c C-t C-p     Print the DVI file.
  69.      C-c C-t C-q     Show the print queue.
  70.      C-c C-t C-d     Delete a job from the print queue.
  71.      C-c C-t C-k     Kill the current TeX formatting job.
  72.      C-c C-t C-x     Quit a currently stopped TeX formatting job.
  73.      C-c C-t C-l     Recenter the output buffer.
  74. Other Updating Commands
  75. -----------------------
  76. The "other updating commands" do not have standard keybindings because
  77. they are used less frequently.
  78. *Note Other Updating Commands::.
  79.      M-x texinfo-insert-node-lines
  80.                      Insert missing `@node' lines using
  81.                      section titles as node names.
  82.      
  83.      M-x texinfo-multiple-files-update
  84.                      Update a multi-file document.
  85.                      With `C-u 8' as a numeric prefix,
  86.                      update  *every* pointer and
  87.                      menu in *all* the files and
  88.                      then insert a master menu.
  89.      
  90.      M-x texinfo-indent-menu-description
  91.                      Indent descriptions in menus.
  92.      
  93.      M-x texinfo-sequential-node-update
  94.                      Insert node pointers in strict sequence.
  95. File: texinfo,  Node: New Commands,  Prev: New Texinfo Mode Commands,  Up: New Features
  96. New Texinfo @-Commands
  97. ======================
  98.    The second edition of the Texinfo manual describes more than 50
  99. commands that were not described in the first edition.  A third or so
  100. of these commands existed in Texinfo but were not documented in the
  101. manual; the others are new.  Here is a listing, with brief descriptions
  102. of them.
  103. Indexing
  104. --------
  105. Create your own index, and merge indices.
  106. *Note Indices::.
  107.      @defindex INDEX-NAME
  108.                   Define a new index and its indexing command.
  109.                   See also the `@defcodeindex' command.
  110.      
  111.      @synindex FROM-INDEX INTO-INDEX
  112.                   Merge first index into second index.
  113.                   See also the `@syncodeindex' command.
  114. Definitions
  115. -----------
  116. Describe functions, variables, macros, commands, user options, special
  117. forms, and other such artifacts in a uniform format.
  118. *Note Definition Commands::.
  119.      @deffn CATEGORY NAME ARGUMENTS...
  120.                   Format a description for functions, interactive
  121.                   commands, and similar entities.
  122.      
  123.      @defvr, @defop, ...
  124.                   15 other related commands.
  125. Glyphs
  126. ------
  127. Indicate the results of evaluation, expansion, printed output, an error
  128. message, equivalence of expressions, and the location of point.
  129. *Note Glyphs::.
  130.      @equiv{}     Equivalence:`=='
  131.      
  132.      @error{}     Error message: `error-->'
  133.      
  134.      @expansion{} Macro expansion: `==>'
  135.      
  136.      @point{}     Position of point: `-!-'
  137.      
  138.      @print{}     Printed output: `-|'
  139.      
  140.      @result{}    Result of an expression: `=>'
  141. Page Headings
  142. -------------
  143. Customize page headings.
  144. *Note Headings::.
  145.      @headings ON-OFF-SINGLE-DOUBLE
  146.                   Headings on or off, single, or double-sided.
  147.      
  148.      @evenfooting [LEFT] @| [CENTER] @| [RIGHT]
  149.                   Footings for even-numbered (left-hand) pages.
  150.      
  151.      @evenheading, @everyheading, @oddheading, ...
  152.                   Five other related commands.
  153.      
  154.      @thischapter
  155.                   Insert name of chapter and chapter number.
  156.      
  157.      @thischaptername, @thisfile, @thistitle, @thispage
  158.                   Related commands.
  159. Formatting
  160. ----------
  161. Format blocks of text.
  162. *Note Quotations and Examples::, and
  163. *Note Making Lists and Tables: Lists and Tables.
  164.      @cartouche   Draw rounded box surrounding text (not in Info).
  165.      
  166.      @enumerate OPTIONAL-ARG
  167.                   Enumerate a list with letters or numbers.
  168.      
  169.      @exdent LINE-OF-TEXT
  170.                   Remove indentation.
  171.      
  172.      @flushleft   Left justify.
  173.      
  174.      @flushright  Right justify.
  175.      
  176.      @format      Do not narrow nor change font.
  177.      
  178.      @ftable FORMATTING-COMMAND
  179.      @vtable FORMATTING-COMMAND
  180.                   Two-column table with indexing.
  181.      
  182.      @lisp        For an example of Lisp code.
  183.      
  184.      @smallexample
  185.      @smalllisp
  186.                   Like @example and @lisp but for @smallbook.
  187. Conditionals
  188. ------------
  189. Conditionally format text.
  190. *Note `@set' and `@clear': set and clear.
  191.      @set FLAG    Set a flag.
  192.      
  193.      @clear FLAG  Clear a flag.
  194.      
  195.      @ifset FLAG  Format, if flag is set.
  196.      
  197.      @ifclear FLAG
  198.                  Ignore, if flag is set.
  199. @heading series for Titles
  200. --------------------------
  201. Produce unnumbered headings that do not appear in a table of contents.
  202. *Note Structuring::.
  203.      @heading TITLE
  204.                   Unnumbered section-like heading not listed
  205.                   in the table of contents of a printed manual.
  206.      
  207.      @chapheading, @majorheading
  208.      @subheading, @subsubheading
  209.                   Related commands.
  210. Font commands
  211. -------------
  212. *Note Smallcaps::, and
  213. *Note Fonts::.
  214.      @r{TEXT}     Print in roman font.
  215.      
  216.      @sc{TEXT}    Print in SMALL CAPS font.
  217. Miscellaneous
  218. -------------
  219. See *Note `@title' `@subtitle' and `@author' Commands: title subtitle
  220. author,
  221. see *Note Overfull hboxes::,
  222. see *Note Footnotes::,
  223. see *Note Format a Dimension: dmn,
  224. see *Note Inserting a Minus Sign: minus,
  225. see *Note Paragraph Indenting: paragraphindent,
  226. see *Note Cross Reference Commands::,
  227. see *Note `@title' `@subtitle' and `@author': title subtitle author, and
  228. see *Note How to Make Your Own Headings: Custom Headings.
  229.      @author AUTHOR
  230.                   Typeset author's name.
  231.      
  232.      @finalout    Produce cleaner printed output.
  233.      
  234.      @footnotestyle
  235.                   Specify footnote style.
  236.      
  237.      @dmn{DIMENSION}
  238.                   Format a dimension.
  239.      
  240.      @minus{}     Generate a minus sign.
  241.      
  242.      @paragraphindent
  243.                   Specify paragraph indentation.
  244.      
  245.      @ref{NODE-NAME, [ENTRY], [TOPIC-OR-TITLE], [INFO-FILE], [MANUAL]}
  246.                   Make a reference.  In the printed manual, the
  247.                   reference does not start with the word `see'.
  248.      
  249.      @title TITLE
  250.                   Typeset TITLE in the alternative
  251.                   title page format.
  252.      
  253.      @subtitle SUBTITLE
  254.                   Typeset SUBTITLE in the alternative
  255.                   title page format.
  256.      
  257.      @today{}     Insert the current date.
  258. File: texinfo,  Node: Command and Variable Index,  Next: Concept Index,  Prev: New Features,  Up: Top
  259. Command and Variable Index
  260. **************************
  261.    This is an alphabetical list of all the @-commands and several
  262. variables.  To make the list easier to use, the commands are listed
  263. without their preceding `@'.
  264. * Menu:
  265. * * (force line break):                 Line Breaks.
  266. * .  (true end of sentence):            Controlling Spacing.
  267. * : (suppress widening):                Controlling Spacing.
  268. * @ (single @):                         Inserting An Atsign.
  269. * { (single {):                         Inserting Braces.
  270. * } (single }):                         Inserting Braces.
  271. * INFOPATH:                             Other Info Directories.
  272. * Info-validate:                        Running Info-Validate.
  273. * TEXINPUTS:                            Preparing for TeX.
  274. * appendix:                             unnumbered & appendix.
  275. * appendixsec:                          unnumberedsec appendixsec heading.
  276. * appendixsection:                      unnumberedsec appendixsec heading.
  277. * appendixsubsec:                       unnumberedsubsec appendixsubsec subheading.
  278. * appendixsubsubsec:                    subsubsection.
  279. * apply:                                Sample Function Definition.
  280. * author:                               title subtitle author.
  281. * b (bold font):                        Fonts.
  282. * buffer-end:                           Def Cmd Template.
  283. * bullet:                               bullet.
  284. * bye:                                  File End.
  285. * bye:                                  Ending a File.
  286. * c (comment):                          Comments.
  287. * cartouche:                            cartouche.
  288. * center:                               titlefont center sp.
  289. * chapheading:                          majorheading & chapheading.
  290. * chapter:                              chapter.
  291. * cindex:                               Indexing Commands.
  292. * cite:                                 cite.
  293. * clear:                                set and clear.
  294. * code:                                 code.
  295. * comment:                              Comments.
  296. * contents:                             Contents.
  297. * copyright:                            copyright symbol.
  298. * copyright:                            Copyright & Permissions.
  299. * defcodeindex:                         New Indices.
  300. * defcv:                                Abstract Objects.
  301. * deffn:                                Functions Commands.
  302. * deffnx:                               deffnx.
  303. * defindex:                             New Indices.
  304. * defivar:                              Abstract Objects.
  305. * defmac:                               Functions Commands.
  306. * defmethod:                            Abstract Objects.
  307. * defop:                                Abstract Objects.
  308. * defopt:                               Variables Commands.
  309. * defspec:                              Functions Commands.
  310. * deftp:                                Data Types.
  311. * deftypefn:                            Typed Functions.
  312. * deftypefun:                           Typed Functions.
  313. * deftypevar:                           Typed Variables.
  314. * deftypevr:                            Typed Variables.
  315. * defun:                                Functions Commands.
  316. * defvar:                               Variables Commands.
  317. * defvr:                                Variables Commands.
  318. * dfn:                                  dfn.
  319. * display:                              display.
  320. * dmn:                                  dmn.
  321. * dots:                                 dots.
  322. * emph:                                 emph & strong.
  323. * end:                                  Quotations and Examples.
  324. * end:                                  Introducing Lists.
  325. * end titlepage:                        end titlepage.
  326. * enumerate:                            enumerate.
  327. * evenfooting:                          Custom Headings.
  328. * evenheading:                          Custom Headings.
  329. * everyfooting:                         Custom Headings.
  330. * everyheading:                         Custom Headings.
  331. * example:                              example.
  332. * exdent:                               exdent.
  333. * file:                                 file.
  334. * filll:                                Copyright & Permissions.
  335. * finalout:                             Overfull hboxes.
  336. * findex:                               Indexing Commands.
  337. * flushleft:                            flushleft & flushright.
  338. * flushright:                           flushleft & flushright.
  339. * foobar:                               Optional Arguments.
  340. * footnote:                             Footnotes.
  341. * footnotestyle:                        Footnotes.
  342. * format:                               format.
  343. * forward-word:                         Def Cmd Template.
  344. * ftable:                               ftable vtable.
  345. * group:                                group.
  346. * heading:                              unnumberedsec appendixsec heading.
  347. * headings:                             headings on off.
  348. * i (italic font):                      Fonts.
  349. * ifclear:                              set and clear.
  350. * ifinfo:                               Conditionals.
  351. * ifset:                                set and clear.
  352. * iftex:                                Conditionals.
  353. * ignore:                               Comments.
  354. * include:                              Using Include Files.
  355. * inforef:                              inforef.
  356. * isearch-backward:                     deffnx.
  357. * isearch-forward:                      deffnx.
  358. * item:                                 table.
  359. * item:                                 itemize.
  360. * itemize:                              itemize.
  361. * itemx:                                itemx.
  362. * kbd:                                  kbd.
  363. * key:                                  key.
  364. * kindex:                               Indexing Commands.
  365. * lisp:                                 Lisp Example.
  366. * lpr (DVI print command):              Shell Format & Print.
  367. * majorheading:                         majorheading & chapheading.
  368. * makeinfo-buffer:                      makeinfo in Emacs.
  369. * makeinfo-kill-job:                    makeinfo in Emacs.
  370. * makeinfo-recenter-output-buffer:      makeinfo in Emacs.
  371. * makeinfo-region:                      makeinfo in Emacs.
  372. * menu:                                 Menus.
  373. * minus:                                minus.
  374. * need:                                 need.
  375. * next-error:                           makeinfo in Emacs.
  376. * noindent:                             noindent.
  377. * occur:                                Using occur.
  378. * occur-mode-goto-occurrence:           Showing the Structure.
  379. * oddfooting:                           Custom Headings.
  380. * oddheading:                           Custom Headings.
  381. * page:                                 page.
  382. * page-delimiter:                       Showing the Structure.
  383. * paragraphindent:                      paragraphindent.
  384. * pindex:                               Indexing Commands.
  385. * printindex:                           Printing Indices & Menus.
  386. * pxref:                                pxref.
  387. * quotation:                            quotation.
  388. * r (Roman font):                       Fonts.
  389. * ref:                                  ref.
  390. * refill:                               Refilling Paragraphs.
  391. * samp:                                 samp.
  392. * sc (small caps font):                 Smallcaps.
  393. * section:                              section.
  394. * set:                                  set and clear.
  395. * setchapternewpage:                    setchapternewpage.
  396. * setfilename:                          setfilename.
  397. * settitle:                             settitle.
  398. * shortcontents:                        Contents.
  399. * smallbook:                            smallbook.
  400. * smallexample:                         smallexample & smalllisp.
  401. * smalllisp:                            smallexample & smalllisp.
  402. * sp (line spacing):                    sp.
  403. * sp (titlepage line spacing):          titlefont center sp.
  404. * strong:                               emph & strong.
  405. * subheading:                           unnumberedsubsec appendixsubsec subheading.
  406. * subsection:                           subsection.
  407. * subsubheading:                        subsubsection.
  408. * subsubsection:                        subsubsection.
  409. * subtitle:                             title subtitle author.
  410. * summarycontents:                      Contents.
  411. * syncodeindex:                         syncodeindex.
  412. * syncodeindex:                         syncodeindex.
  413. * synindex:                             synindex.
  414. * t (typewriter font):                  Fonts.
  415. * table:                                Two-column Tables.
  416. * tex (command):                        tex.
  417. * texi2dvi (shell script):              Shell Format & Print.
  418. * texindex:                             Format/Print Hardcopy.
  419. * texindex:                             Shell Format & Print.
  420. * texinfo-all-menus-update:             Updating Commands.
  421. * texinfo-every-node-update:            Updating Commands.
  422. * texinfo-format-buffer:                texinfo-format commands.
  423. * texinfo-format-buffer:                Info Formatting.
  424. * texinfo-format-buffer:                texinfo-format commands.
  425. * texinfo-format-region:                texinfo-format commands.
  426. * texinfo-format-region:                texinfo-format commands.
  427. * texinfo-format-region:                Info Formatting.
  428. * texinfo-indent-menu-description:      Other Updating Commands.
  429. * texinfo-insert-@code:                 Inserting.
  430. * texinfo-insert-@dfn:                  Inserting.
  431. * texinfo-insert-@end:                  Inserting.
  432. * texinfo-insert-@example:              Inserting.
  433. * texinfo-insert-@item:                 Inserting.
  434. * texinfo-insert-@kbd:                  Inserting.
  435. * texinfo-insert-@node:                 Inserting.
  436. * texinfo-insert-@noindent:             Inserting.
  437. * texinfo-insert-@samp:                 Inserting.
  438. * texinfo-insert-@table:                Inserting.
  439. * texinfo-insert-@var:                  Inserting.
  440. * texinfo-insert-braces:                Inserting.
  441. * texinfo-insert-node-lines:            Other Updating Commands.
  442. * texinfo-make-menu:                    Updating Commands.
  443. * texinfo-master-menu:                  Updating Commands.
  444. * texinfo-multiple-files-update:        Other Updating Commands.
  445. * texinfo-multiple-files-update:        texinfo-multiple-files-update.
  446. * texinfo-sequential-node-update:       Other Updating Commands.
  447. * texinfo-show-structure:               Showing the Structure.
  448. * texinfo-show-structure:               Using texinfo-show-structure.
  449. * texinfo-tex-buffer:                   Printing.
  450. * texinfo-tex-print:                    Printing.
  451. * texinfo-tex-region:                   Printing.
  452. * texinfo-update-node:                  Updating Commands.
  453. * thischapter:                          Custom Headings.
  454. * thischaptername:                      Custom Headings.
  455. * thisfile:                             Custom Headings.
  456. * thispage:                             Custom Headings.
  457. * thistitle:                            Custom Headings.
  458. * tindex:                               Indexing Commands.
  459. * title:                                title subtitle author.
  460. * titlefont:                            titlefont center sp.
  461. * titlepage:                            titlepage.
  462. * today:                                Custom Headings.
  463. * top (@-command):                      makeinfo top command.
  464. * unnumbered:                           unnumbered & appendix.
  465. * unnumberedsec:                        unnumberedsec appendixsec heading.
  466. * unnumberedsubsec:                     unnumberedsubsec appendixsubsec subheading.
  467. * unnumberedsubsubsec:                  subsubsection.
  468. * up-list:                              Inserting.
  469. * var:                                  var.
  470. * vindex:                               Indexing Commands.
  471. * vskip:                                Copyright & Permissions.
  472. * vtable:                               ftable vtable.
  473. * w (prevent line break):               w.
  474. * xref:                                 xref.
  475. File: texinfo,  Node: Concept Index,  Prev: Command and Variable Index,  Up: Top
  476. Concept Index
  477. *************
  478. * Menu:
  479. * @-Command Syntax:                     Command Syntax.
  480. * @-Command list:                       Command List.
  481. * @-commands:                           Formatting Commands.
  482. * TeX commands, using ordinary:         Using Ordinary TeX Commands.
  483. * TeX index sorting:                    Format/Print Hardcopy.
  484. * TeX input initialization:             Preparing for TeX.
  485. * TeX, how to obtain:                   Obtaining TeX.
  486. * .cshrc initialization file:           Preparing for TeX.
  487. * .profile initialization file:         Preparing for TeX.
  488. * @include file sample:                 Sample Include File.
  489. * @menu entry writing:                  Writing a Menu Entry.
  490. * @node line writing:                   Writing a Node.
  491. * TEXINPUTS environment variable:       Preparing for TeX.
  492. * makeinfo inside Emacs:                makeinfo in Emacs.
  493. * makeinfo options:                     makeinfo options.
  494. * dir directory for Info installation:  Install an Info File.
  495. * dir file listing:                     New Info File.
  496. * End node footnote style:              Footnotes.
  497. * Separate footnote style:              Footnotes.
  498. * Top node:                             The Top Node.
  499. * Top node is first:                    First Node.
  500. * Top node naming for references:       Top Node Naming.
  501. * Top node summary:                     Top Node Summary.
  502. * ifinfo permissions:                   ifinfo Permissions.
  503. * Abbreviations for keys:               key.
  504. * Adding a new info file:               New Info File.
  505. * Alphabetical @-command list:          Command List.
  506. * Another Info directory:               Other Info Directories.
  507. * Arguments, repeated and optional:     Optional Arguments.
  508. * Automatic pointer creation with makeinfo: makeinfo Pointer Creation.
  509. * Automatically insert nodes, menus:    Updating Nodes and Menus.
  510. * Badly referenced nodes:               Running Info-Validate.
  511. * Beginning a Texinfo file:             Beginning a File.
  512. * Beginning line of a Texinfo file:     First Line.
  513. * Black rectangle in hardcopy:          Overfull hboxes.
  514. * Blank lines:                          sp.
  515. * Book characteristics, printed:        Printed Books.
  516. * Book, printing small:                 smallbook.
  517. * Box with rounded corners:             cartouche.
  518. * Braces and argument syntax:           Command Syntax.
  519. * Braces, inserting:                    Braces Atsigns Periods.
  520. * Braces, when to use:                  Formatting Commands.
  521. * Breaks in a line:                     Line Breaks.
  522. * Buffer formatting and printing:       Printing.
  523. * Bullets, inserting:                   Dots Bullets.
  524. * Capitalizing index entries:           Indexing Commands.
  525. * Catching errors with TeX formatting:  Debugging with TeX.
  526. * Catching errors with Info formatting: Debugging with Info.
  527. * Catching mistakes:                    Catching Mistakes.
  528. * Chapter structuring:                  Structuring.
  529. * Characteristics, printed books or manuals: Printed Books.
  530. * Checking for badly referenced nodes:  Running Info-Validate.
  531. * Combining indices:                    Combining Indices.
  532. * Command definitions:                  Sample Function Definition.
  533. * Commands to insert single characters: Braces Atsigns Periods.
  534. * Commands using ordinary TeX:          Using Ordinary TeX Commands.
  535. * Commands, inserting them:             Inserting.
  536. * Comments:                             Comments.
  537. * Compile command for formatting:       Compile-Command.
  538. * Conditionally visible text:           Conditionals.
  539. * Conditions for copying Texinfo:       Copying.
  540. * Contents, Table of:                   Contents.
  541. * Contents-like outline of file structure: Showing the Structure.
  542. * Conventions for writing definitions:  Def Cmd Conventions.
  543. * Conventions, syntactic:               Conventions.
  544. * Copying conditions:                   Copying.
  545. * Copying permissions:                  Sample Permissions.
  546. * Copying software:                     Software Copying Conditions.
  547. * Copyright page:                       Copyright & Permissions.
  548. * Correcting mistakes:                  Catching Mistakes.
  549. * Create nodes, menus automatically:    Updating Nodes and Menus.
  550. * Creating an Info file:                Create an Info File.
  551. * Creating an unsplit file:             Unsplit.
  552. * Creating index entries:               Indexing Commands.
  553. * Creating indices:                     Indices.
  554. * Creating pointers with makeinfo:      makeinfo Pointer Creation.
  555. * Cross reference parts:                Cross Reference Parts.
  556. * Cross references:                     Cross References.
  557. * Cross references using @inforef:      inforef.
  558. * Cross references using @pxref:        pxref.
  559. * Cross references using @ref:          ref.
  560. * Cross references using @xref:         xref.
  561. * DVI file:                             Shell Format & Print.
  562. * Debugging the Texinfo structure:      Catching Mistakes.
  563. * Debugging with TeX formatting:        Debugging with TeX.
  564. * Debugging with Info formatting:       Debugging with Info.
  565. * Defining indexing entries:            Indexing Commands.
  566. * Defining new indices:                 New Indices.
  567. * Definition commands:                  Definition Commands.
  568. * Definition conventions:               Def Cmd Conventions.
  569. * Definition template:                  Def Cmd Template.
  570. * Definitions grouped together:         deffnx.
  571. * Different cross reference commands:   Cross Reference Commands.
  572. * Dimension formatting:                 dmn.
  573. * Display formatting:                   display.
  574. * Distribution:                         Software Copying Conditions.
  575. * Dots, inserting:                      Dots Bullets.
  576. * Dots, inserting:                      dots.
  577. * Ellipsis, inserting:                  Dots Bullets.
  578. * Emacs:                                Texinfo Mode.
  579. * Emacs shell, format, print from:      Within Emacs.
  580. * Emphasizing text:                     Emphasis.
  581. * Emphasizing text, font for:           emph & strong.
  582. * End of header line:                   End of Header.
  583. * End titlepage starts headings:        end titlepage.
  584. * Ending a Texinfo file:                Ending a File.
  585. * Entries for an index:                 Indexing Commands.
  586. * Entries, making index:                Index Entries.
  587. * Enumeration:                          enumerate.
  588. * Equivalence, indicating it:           Equivalence.
  589. * Error message, indicating it:         Error Glyph.
  590. * Errors, parsing:                      makeinfo in Emacs.
  591. * Evaluation glyph:                     result.
  592. * Example for a small book:             smallexample & smalllisp.
  593. * Example menu:                         Menu Example.
  594. * Examples, formatting them:            example.
  595. * Expansion, indicating it:             expansion.
  596. * File beginning:                       Beginning a File.
  597. * File ending:                          Ending a File.
  598. * File section structure, showing it:   Showing the Structure.
  599. * Filling paragraphs:                   Refilling Paragraphs.
  600. * Final output:                         Overfull hboxes.
  601. * Finding badly referenced nodes:       Running Info-Validate.
  602. * First line of a Texinfo file:         First Line.
  603. * First node:                           First Node.
  604. * Fonts for indices:                    syncodeindex.
  605. * Fonts for printing, not for Info:     Fonts.
  606. * Footings:                             Headings.
  607. * Footnotes:                            Footnotes.
  608. * Format a dimension:                   dmn.
  609. * Format and print hardcopy:            Format/Print Hardcopy.
  610. * Format and print in Texinfo mode:     Texinfo Mode Printing.
  611. * Format with the compile command:      Compile-Command.
  612. * Format, print from Emacs shell:       Within Emacs.
  613. * Formatting a file for Info:           Create an Info File.
  614. * Formatting commands:                  Formatting Commands.
  615. * Formatting examples:                  example.
  616. * Formatting for Info:                  Info Formatting.
  617. * Formatting for printing:              Printing.
  618. * Formatting headings and footings:     Headings.
  619. * Formatting requirements:              Requirements Summary.
  620. * Frequently used commands, inserting:  Inserting.
  621. * Function definitions:                 Sample Function Definition.
  622. * GNU Emacs:                            Texinfo Mode.
  623. * GNU Emacs shell, format, print from:  Within Emacs.
  624. * General syntactic conventions:        Conventions.
  625. * Generating menus with indices:        Printing Indices & Menus.
  626. * Glyphs:                               Glyphs.
  627. * Going to other Info files' nodes:     Other Info Files.
  628. * Group (hold text together vertically): group.
  629. * Grouping two definitions together:    deffnx.
  630. * Hardcopy, printing it:                Format/Print Hardcopy.
  631. * Header for Texinfo files:             Header.
  632. * Header of a Texinfo file:             First Line.
  633. * Headings:                             Headings.
  634. * Headings, page, begin to appear:      end titlepage.
  635. * Highlighting text:                    Indicating.
  636. * Hints:                                Tips.
  637. * Holding text together vertically:     group.
  638. * If text conditionally visible:        Conditionals.
  639. * Ignored text:                         Comments.
  640. * Include file requirements:            Include File Requirements.
  641. * Include files:                        Include Files.
  642. * Indentation undoing:                  exdent.
  643. * Indenting paragraphs:                 paragraphindent.
  644. * Index entries:                        Indexing Commands.
  645. * Index entries, making:                Index Entries.
  646. * Index entry capitalization:           Indexing Commands.
  647. * Index font types:                     Indexing Commands.
  648. * Indexing table entries automatically: ftable vtable.
  649. * Indicating commands, definitions, etc.: Indicating.
  650. * Indicating evaluation:                result.
  651. * Indices:                              Indices.
  652. * Indices, combining them:              Combining Indices.
  653. * Indices, defining new:                New Indices.
  654. * Indices, printing and menus:          Printing Indices & Menus.
  655. * Indices, sorting:                     Format/Print Hardcopy.
  656. * Indices, two letter names:            syncodeindex.
  657. * Indirect subfiles:                    Tag and Split Files.
  658. * Info file installation:               Install an Info File.
  659. * Info file requires @setfilename:      setfilename.
  660. * Info file, listing new one:           New Info File.
  661. * Info file, splitting manually:        Splitting.
  662. * Info files:                           Info Files.
  663. * Info formatting:                      Info Formatting.
  664. * Info installed in another directory:  Other Info Directories.
  665. * Info validating a large file:         Using Info-validate.
  666. * Info, creating an on-line file:       Create an Info File.
  667. * Info; other files' nodes:             Other Info Files.
  668. * Initialization file for TeX input:    Preparing for TeX.
  669. * Insert nodes, menus automatically:    Updating Nodes and Menus.
  670. * Inserting @, braces, and periods:     Braces Atsigns Periods.
  671. * Inserting dots:                       Dots Bullets.
  672. * Inserting dots:                       dots.
  673. * Inserting ellipsis:                   Dots Bullets.
  674. * Inserting frequently used commands:   Inserting.
  675. * Inserting special characters and symbols: Insertions.
  676. * Installing Info in another directory: Other Info Directories.
  677. * Installing an Info file:              Install an Info File.
  678. * Introduction, as part of file:        Software Copying Conditions.
  679. * Itemization:                          itemize.
  680. * Keys, recommended names:              key.
  681. * License agreement:                    Software Copying Conditions.
  682. * Line breaks:                          Line Breaks.
  683. * Line breaks, preventing:              w.
  684. * Line spacing:                         sp.
  685. * Lisp example:                         Lisp Example.
  686. * Lisp example for a small book:        smallexample & smalllisp.
  687. * List of  @-Commands:                  Command List.
  688. * Listing a new info file:              New Info File.
  689. * Lists and tables, making them:        Lists and Tables.
  690. * Local variables:                      Compile-Command.
  691. * Location of menus:                    Menu Location.
  692. * Looking for badly referenced nodes:   Running Info-Validate.
  693. * META key:                             key.
  694. * Macro definitions:                    Sample Function Definition.
  695. * Making a printed manual:              Format/Print Hardcopy.
  696. * Making a tag table automatically:     Tag and Split Files.
  697. * Making a tag table manually:          Unsplit.
  698. * Making cross references:              Cross References.
  699. * Making line and page breaks:          Breaks.
  700. * Making lists and tables:              Lists and Tables.
  701. * Manual characteristics, printed:      Printed Books.
  702. * Marking text within a paragraph:      Marking Text.
  703. * Marking words and phrases:            Marking Text.
  704. * Master menu:                          The Top Node.
  705. * Master menu parts:                    Master Menu Parts.
  706. * Menu entry writing:                   Writing a Menu Entry.
  707. * Menu example:                         Menu Example.
  708. * Menu location:                        Menu Location.
  709. * Menu writing:                         Writing a Menu.
  710. * Menus:                                Menus.
  711. * Menus generated with indices:         Printing Indices & Menus.
  712. * Meta-syntactic chars for arguments:   Optional Arguments.
  713. * Minimal Texinfo file (requirements):  Minimum.
  714. * Mistakes, catching:                   Catching Mistakes.
  715. * Mode, using Texinfo:                  Texinfo Mode.
  716. * Must have in Texinfo file:            Minimum.
  717. * Names for indices:                    syncodeindex.
  718. * Names recommended for keys:           key.
  719. * Naming a `Top' Node in references:    Top Node Naming.
  720. * Need space at page bottom:            need.
  721. * New index defining:                   New Indices.
  722. * New info file, listing it:            New Info File.
  723. * Node line writing:                    Writing a Node.
  724. * Node, `Top':                          The Top Node.
  725. * Node, defined:                        node.
  726. * Nodes for menus are short:            Menu Location.
  727. * Nodes in other Info files:            Other Info Files.
  728. * Nodes, catching mistakes:             Catching Mistakes.
  729. * Nodes, checking for badly referenced: Running Info-Validate.
  730. * Obtaining TeX:                        Obtaining TeX.
  731. * Occurrences, listing with @occur:     Using occur.
  732. * Optional and repeated arguments:      Optional Arguments.
  733. * Options for makeinfo:                 makeinfo options.
  734. * Ordinary TeX commands, using:         Using Ordinary TeX Commands.
  735. * Other Info files' nodes:              Other Info Files.
  736. * Outline of file structure, showing it: Showing the Structure.
  737. * Overfull "hboxes":                    Overfull hboxes.
  738. * Overview of Texinfo:                  Overview.
  739. * Page breaks:                          page.
  740. * Page delimiter in Texinfo mode:       Showing the Structure.
  741. * Page headings:                        Headings.
  742. * Page numbering:                       Headings.
  743. * Page sizes for books:                 smallbook.
  744. * Pages, starting odd:                  setchapternewpage.
  745. * Paragraph indentation:                paragraphindent.
  746. * Paragraph, marking text within:       Marking Text.
  747. * Parsing errors:                       makeinfo in Emacs.
  748. * Part of file formatting and printing: Printing.
  749. * Parts of a cross reference:           Cross Reference Parts.
  750. * Parts of a master menu:               Master Menu Parts.
  751. * Periods, inserting:                   Braces Atsigns Periods.
  752. * Permissions:                          Sample Permissions.
  753. * Permissions, printed:                 Copyright & Permissions.
  754. * PlainTeX:                             Using Ordinary TeX Commands.
  755. * Point, indicating it in a buffer:     Point Glyph.
  756. * Pointer creation with makeinfo:       makeinfo Pointer Creation.
  757. * Pointer validation with makeinfo:     Pointer Validation.
  758. * Preparing to use TeX:                 Preparing for TeX.
  759. * Preventing line and page breaks:      Breaks.
  760. * Print and format in Texinfo mode:     Texinfo Mode Printing.
  761. * Print, format from Emacs shell:       Within Emacs.
  762. * Printed book and manual characteristics: Printed Books.
  763. * Printed output, indicating it:        Print Glyph.
  764. * Printed permissions:                  Copyright & Permissions.
  765. * Printing a region or buffer:          Printing.
  766. * Printing an index:                    Printing Indices & Menus.
  767. * Problems, catching:                   Catching Mistakes.
  768. * Quotations:                           quotation.
  769. * Recommended names for keys:           key.
  770. * Rectangle, ugly, black in hardcopy:   Overfull hboxes.
  771. * References:                           Cross References.
  772. * References using @inforef:            inforef.
  773. * References using @pxref:              pxref.
  774. * References using @ref:                ref.
  775. * References using @xref:               xref.
  776. * Referring to other Info files:        Other Info Files.
  777. * Refilling paragraphs:                 Refilling Paragraphs.
  778. * Region formatting and printing:       Printing.
  779. * Region printing in Texinfo mode:      Texinfo Mode Printing.
  780. * Repeated and optional arguments:      Optional Arguments.
  781. * Required in Texinfo file:             Minimum.
  782. * Requirements for formatting:          Requirements Summary.
  783. * Requirements for include files:       Include File Requirements.
  784. * Requirements for updating commands:   Updating Requirements.
  785. * Result of an expression:              result.
  786. * Running Info-validate:                Using Info-validate.
  787. * Running makeinfo in Emacs:            makeinfo in Emacs.
  788. * Running an Info formatter:            Info Formatting.
  789. * Sample @include file:                 Sample Include File.
  790. * Sample Texinfo file:                  Short Sample.
  791. * Sample Texinfo file, no comments:     Sample Texinfo File.
  792. * Sample function definition:           Sample Function Definition.
  793. * Section structure of a file, showing it: Showing the Structure.
  794. * Shell, format, print from:            Within Emacs.
  795. * Shell, running makeinfo in:           makeinfo in Emacs.
  796. * Short nodes for menus:                Menu Location.
  797. * Showing the section structure of a file: Showing the Structure.
  798. * Showing the structure of a file:      Using texinfo-show-structure.
  799. * Single characters, commands to insert: Braces Atsigns Periods.
  800. * Size of printed book:                 smallbook.
  801. * Small book example:                   smallexample & smalllisp.
  802. * Small book size:                      smallbook.
  803. * Small caps font:                      Smallcaps.
  804. * Software copying conditions:          Software Copying Conditions.
  805. * Sorting indices:                      Format/Print Hardcopy.
  806. * Spaces (blank lines):                 sp.
  807. * Special insertions:                   Insertions.
  808. * Special typesetting commands:         Dots Bullets.
  809. * Specifying index entries:             Indexing Commands.
  810. * Splitting an Info file manually:      Splitting.
  811. * Start of header line:                 Start of Header.
  812. * Starting chapters:                    setchapternewpage.
  813. * Structure of a file, showing it:      Showing the Structure.
  814. * Structure, catching mistakes in:      Catching Mistakes.
  815. * Structuring of chapters:              Structuring.
  816. * Subsection-like commands:             unnumberedsubsec appendixsubsec subheading.
  817. * Subsub commands:                      subsubsection.
  818. * Syntactic conventions:                Conventions.
  819. * Syntax, optional & repeated arguments: Optional Arguments.
  820. * Table of contents:                    Contents.
  821. * Tables and lists, making them:        Lists and Tables.
  822. * Tables with indexes:                  ftable vtable.
  823. * Tables, making two-column:            Two-column Tables.
  824. * Tabs; don't use!:                     Conventions.
  825. * Tag table, making automatically:      Tag and Split Files.
  826. * Tag table, making manually:           Unsplit.
  827. * Template for a definition:            Def Cmd Template.
  828. * Texinfo file beginning:               Beginning a File.
  829. * Texinfo file ending:                  Ending a File.
  830. * Texinfo file header:                  Header.
  831. * Texinfo file minimum:                 Minimum.
  832. * Texinfo file section structure, showing it: Showing the Structure.
  833. * Texinfo mode:                         Texinfo Mode.
  834. * Texinfo overview:                     Overview.
  835. * Texinfo printed book characteristics: Printed Books.
  836. * Text, conditionally visible:          Conditionals.
  837. * Thin space between number, dimension: dmn.
  838. * Tips:                                 Tips.
  839. * Title page:                           titlepage.
  840. * Titlepage end starts headings:        end titlepage.
  841. * Titlepage permissions:                Titlepage Permissions.
  842. * Tree structuring:                     Tree Structuring.
  843. * Two `First' Lines for @deffn:         deffnx.
  844. * Two letter names for indices:         syncodeindex.
  845. * Two named items for @table:           itemx.
  846. * Typesetting commands for dots, etc.:  Dots Bullets.
  847. * Unprocessed text:                     Comments.
  848. * Unsplit file creation:                Unsplit.
  849. * Updating nodes and menus:             Updating Nodes and Menus.
  850. * Updating requirements:                Updating Requirements.
  851. * Usage tips:                           Tips.
  852. * Validating a large file:              Using Info-validate.
  853. * Validation of pointers:               Pointer Validation.
  854. * Value of an expression, indicating:   result.
  855. * Vertical whitespace (vskip):          Copyright & Permissions.
  856. * Vertically holding text together:     group.
  857. * Visibility of conditional text:       Conditionals.
  858. * Words and phrases, marking them:      Marking Text.
  859. * Writing a menu:                       Writing a Menu.
  860. * Writing a menu entry:                 Writing a Menu Entry.
  861. * Writing an @node line:                Writing a Node.
  862. * hboxes, overfull:                     Overfull hboxes.
  863.