\unnumbchapentry{Texinfo Copying Conditions}{2} \chapentry{Overview of Texinfo}{1}{3} \secentry{Reporting Bugs}{1}{1}{3} \secentry{Using Texinfo}{1}{2}{3} \secentry{Info files}{1}{3}{5} \secentry{Printed Books}{1}{4}{6} \secentry{@-commands}{1}{5}{7} \secentry{General Syntactic Conventions}{1}{6}{8} \secentry{Comments}{1}{7}{9} \secentry{What a Texinfo File Must Have}{1}{8}{9} \secentry{Six Parts of a Texinfo File}{1}{9}{10} \secentry{A Short Sample Texinfo File}{1}{10}{10} \secentry{Acknowledgements and History}{1}{11}{12} \chapentry{Using Texinfo Mode}{2}{14} \secentry{The Usual GNU Emacs Editing Commands}{2}{1}{14} \secentry{Inserting Frequently Used Commands}{2}{2}{15} \secentry{Showing the Section Structure of a File}{2}{3}{16} \secentry{Updating Nodes and Menus}{2}{4}{17} \subsecentry{Updating Requirements}{2}{4}{1}{20} \subsecentry{Other Updating Commands}{2}{4}{2}{20} \secentry{Formatting for Info}{2}{5}{21} \secentry{Formatting and Printing}{2}{6}{22} \secentry{Texinfo Mode Summary}{2}{7}{23} \chapentry{Beginning a Texinfo File}{3}{26} \secentry{Sample Texinfo File Beginning}{3}{1}{26} \secentry{The Texinfo File Header}{3}{2}{27} \subsecentry{The First Line of a Texinfo File}{3}{2}{1}{28} \subsecentry{Start of Header}{3}{2}{2}{28} \subsecentry{\code {@setfilename}}{3}{2}{3}{28} \subsecentry{\code {@settitle}}{3}{2}{4}{29} \subsecentry{\code {@setchapternewpage}}{3}{2}{5}{30} \subsecentry{Paragraph Indenting}{3}{2}{6}{31} \subsecentry{\code {@exampleindent}: Environment Indenting}{3}{2}{7}{31} \subsecentry{End of Header}{3}{2}{8}{31} \secentry{Summary and Copying Permissions for Info}{3}{3}{32} \secentry{The Title and Copyright Pages}{3}{4}{32} \subsecentry{\code {@titlepage}}{3}{4}{1}{32} \subsecentry{\code {@titlefont}, \code {@center}, and \code {@sp}}{3}{4}{2}{33} \subsecentry{\code {@title}, \code {@subtitle}, and \code {@author}}{3}{4}{3}{34} \subsecentry{Copyright Page and Permissions}{3}{4}{4}{35} \subsecentry{Heading Generation}{3}{4}{5}{36} \subsecentry{The \code {@headings} Command}{3}{4}{6}{36} \secentry{The `Top' Node and Master Menu}{3}{5}{37} \subsecentry{`Top' Node Title}{3}{5}{1}{37} \subsecentry{Parts of a Master Menu}{3}{5}{2}{38} \secentry{Software Copying Permissions}{3}{6}{39} \chapentry{Ending a Texinfo File}{4}{40} \secentry{Index Menus and Printing an Index}{4}{1}{40} \secentry{Generating a Table of Contents}{4}{2}{41} \secentry{\code {@bye} File Ending}{4}{3}{42} \chapentry{Chapter Structuring}{5}{43} \secentry{Tree Structure of Sections}{5}{1}{43} \secentry{Structuring Command Types}{5}{2}{43} \secentry{\code {@top}}{5}{3}{44} \secentry{\code {@chapter}}{5}{4}{44} \secentry{\code {@unnumbered} and \code {@appendix}}{5}{5}{45} \secentry{\code {@majorheading}, \code {@chapheading}}{5}{6}{45} \secentry{\code {@section}}{5}{7}{45} \secentry{\code {@unnumberedsec}, \code {@appendixsec}, \code {@heading}}{5}{8}{46} \secentry{The \code {@subsection} Command}{5}{9}{46} \secentry{The \code {@subsection}-like Commands}{5}{10}{47} \secentry{The `subsub' Commands}{5}{11}{47} \secentry{\code {@raisesections} and \code {@lowersections}}{5}{12}{48} \chapentry{Nodes}{6}{49} \secentry{Two Paths}{6}{1}{49} \secentry{Node and Menu Illustration}{6}{2}{49} \secentry{The \code {@node} Command}{6}{3}{51} \subsecentry{Choosing Node and Pointer Names}{6}{3}{1}{51} \subsecentry{How to Write an \code {@node} Line}{6}{3}{2}{52} \subsecentry{\code {@node} Line Tips}{6}{3}{3}{52} \subsecentry{\code {@node} Line Requirements}{6}{3}{4}{53} \subsecentry{The First Node}{6}{3}{5}{53} \subsecentry{The \code {@top} Sectioning Command}{6}{3}{6}{54} \subsecentry{The `Top' Node Summary}{6}{3}{7}{54} \secentry{Creating Pointers with \code {makeinfo}}{6}{4}{54} \secentry{\code {@anchor}: Defining Arbitrary Cross-reference Targets}{6}{5}{55} \chapentry{Menus}{7}{56} \secentry{Writing a Menu}{7}{1}{56} \secentry{The Parts of a Menu}{7}{2}{57} \secentry{Less Cluttered Menu Entry}{7}{3}{57} \secentry{A Menu Example}{7}{4}{58} \secentry{Referring to Other Info Files}{7}{5}{58} \chapentry{Cross References}{8}{60} \secentry{Different Cross Reference Commands}{8}{1}{60} \secentry{Parts of a Cross Reference}{8}{2}{61} \secentry{\code {@xref}}{8}{3}{62} \subsecentry{\code {@xref} with One Argument}{8}{3}{1}{62} \subsecentry{\code {@xref} with Two Arguments}{8}{3}{2}{63} \subsecentry{\code {@xref} with Three Arguments}{8}{3}{3}{64} \subsecentry{\code {@xref} with Four and Five Arguments}{8}{3}{4}{65} \secentry{Naming a `Top' Node}{8}{4}{66} \secentry{\code {@ref}}{8}{5}{66} \secentry{\code {@pxref}}{8}{6}{67} \secentry{\code {@inforef}}{8}{7}{68} \secentry{\code {@uref{\tt\char 123}\var {url}[, \var {text}][, \var {replacement}]{\tt\char 125}}}{8}{8}{68} \chapentry{Marking Words and Phrases}{9}{70} \secentry{Indicating Definitions, Commands, etc.}{9}{1}{70} \subsecentry{\code {@code}{\tt\char 123}\var {sample-code}{\tt\char 125}}{9}{1}{1}{71} \subsecentry{\code {@kbd}{\tt\char 123}\var {keyboard-characters}{\tt\char 125}}{9}{1}{2}{72} \subsecentry{\code {@key}{\tt\char 123}\var {key-name}{\tt\char 125}}{9}{1}{3}{73} \subsecentry{\code {@samp}{\tt\char 123}\var {text}{\tt\char 125}}{9}{1}{4}{73} \subsecentry{\code {@var}{\tt\char 123}\var {metasyntactic-variable}{\tt\char 125}}{9}{1}{5}{74} \subsecentry{\code {@env}{\tt\char 123}\var {environment-variable}{\tt\char 125}}{9}{1}{6}{75} \subsecentry{\code {@file}{\tt\char 123}\var {file-name}{\tt\char 125}}{9}{1}{7}{75} \subsecentry{\code {@command}{\tt\char 123}\var {command-name}{\tt\char 125}}{9}{1}{8}{75} \subsecentry{\code {@option}{\tt\char 123}\var {option-name}{\tt\char 125}}{9}{1}{9}{76} \subsecentry{\code {@dfn}{\tt\char 123}\var {term}{\tt\char 125}}{9}{1}{10}{76} \subsecentry{\code {@cite}{\tt\char 123}\var {reference}{\tt\char 125}}{9}{1}{11}{76} \subsecentry{\code {@acronym}{\tt\char 123}\var {acronym}{\tt\char 125}}{9}{1}{12}{76} \subsecentry{\code {@url}{\tt\char 123}\var {uniform-resource-locator}{\tt\char 125}}{9}{1}{13}{76} \subsecentry{\code {@email}{\tt\char 123}\var {email-address}[, \var {displayed-text}]{\tt\char 125}}{9}{1}{14}{77} \secentry{Emphasizing Text}{9}{2}{77} \subsecentry{\code {@emph}{\tt\char 123}\var {text}{\tt\char 125} and \code {@strong}{\tt\char 123}\var {text}{\tt\char 125}}{9}{2}{1}{77} \subsecentry{\code {@sc}{\tt\char 123}\var {text}{\tt\char 125}: The Small Caps Font}{9}{2}{2}{78} \subsecentry{Fonts for Printing, Not Info}{9}{2}{3}{78} \chapentry{Quotations and Examples}{10}{79} \secentry{Block Enclosing Commands}{10}{1}{79} \secentry{\code {@quotation}}{10}{2}{80} \secentry{\code {@example}}{10}{3}{80} \secentry{\code {@noindent}}{10}{4}{81} \secentry{\code {@lisp}}{10}{5}{81} \secentry{\code {@small\dots {}} Block Commands}{10}{6}{82} \secentry{\code {@display} and \code {@smalldisplay}}{10}{7}{83} \secentry{\code {@format} and \code {@smallformat}}{10}{8}{83} \secentry{\code {@exdent}: Undoing a Line's Indentation}{10}{9}{83} \secentry{\code {@flushleft} and \code {@flushright}}{10}{10}{84} \secentry{Drawing Cartouches Around Examples}{10}{11}{84} \chapentry{Lists and Tables}{11}{86} \secentry{\code {@itemize}: Making an Itemized List}{11}{1}{86} \secentry{\code {@enumerate}: Making a Numbered or Lettered List}{11}{2}{88} \secentry{Making a Two-column Table}{11}{3}{89} \subsecentry{\code {@ftable} and \code {@vtable}}{11}{3}{1}{90} \subsecentry{\code {@itemx}}{11}{3}{2}{90} \secentry{Multi-column Tables}{11}{4}{91} \subsecentry{Multitable Column Widths}{11}{4}{1}{91} \subsecentry{Multitable Rows}{11}{4}{2}{91} \chapentry{Indices}{12}{93} \secentry{Making Index Entries}{12}{1}{93} \secentry{Predefined Indices}{12}{2}{93} \secentry{Defining the Entries of an Index}{12}{3}{94} \secentry{Combining Indices}{12}{4}{95} \subsecentry{\code {@syncodeindex}}{12}{4}{1}{95} \subsecentry{\code {@synindex}}{12}{4}{2}{96} \secentry{Defining New Indices}{12}{5}{96} \chapentry{Special Insertions}{13}{98} \secentry{Inserting @ and Braces}{13}{1}{98} \subsecentry{Inserting \samp {@} with @@}{13}{1}{1}{98} \subsecentry{Inserting \samp {{\tt\char 123}} and \samp {{\tt\char 125}}with @{\tt\char 123} and @{\tt\char 125}}{13}{1}{2}{98} \secentry{Inserting Space}{13}{2}{98} \subsecentry{Not Ending a Sentence}{13}{2}{1}{99} \subsecentry{Ending a Sentence}{13}{2}{2}{99} \subsecentry{Multiple Spaces}{13}{2}{3}{99} \subsecentry{\code {@dmn}{\tt\char 123}\var {dimension}{\tt\char 125}: Format a Dimension}{13}{2}{4}{100} \secentry{Inserting Accents}{13}{3}{100} \secentry{Inserting Ellipsis and Bullets}{13}{4}{101} \subsecentry{\code {@dots}{\tt\char 123}{\tt\char 125} (\dots {}) and \code {@enddots}{\tt\char 123}{\tt\char 125} (\unhbox \voidb@x \hbox to 2em{\hskip 0pt plus 0.25fil minus 0.25fil .\hss .\hss .\hss .\hskip 0pt plus 0.5fil minus 0.5fil }\spacefactor =3000 {})}{13}{4}{1}{101} \subsecentry{\code {@bullet}{\tt\char 123}{\tt\char 125} (\implicitmath \ptexbullet \implicitmath {})}{13}{4}{2}{102} \secentry{Inserting \TeX{} and the Copyright Symbol}{13}{5}{102} \subsecentry{\code {@TeX}{\tt\char 123}{\tt\char 125} (\TeX{})}{13}{5}{1}{102} \subsecentry{\code {@copyright}{\tt\char 123}{\tt\char 125} (\copyright{})}{13}{5}{2}{102} \secentry{\code {@pounds}{\tt\char 123}{\tt\char 125} ({\fam \itfam \tenit \$}{}): Pounds Sterling}{13}{6}{102} \secentry{\code {@minus}{\tt\char 123}{\tt\char 125} (\implicitmath -\implicitmath {}): Inserting a Minus Sign}{13}{7}{102} \secentry{\code {@math}: Inserting Mathematical Expressions}{13}{8}{103} \secentry{Glyphs for Examples}{13}{9}{103} \subsecentry{\code {@result{\tt\char 123}{\tt\char 125}} (\result{}): Indicating Evaluation}{13}{9}{1}{103} \subsecentry{\code {@expansion{\tt\char 123}{\tt\char 125}} (\expansion{}): Indicating an Expansion}{13}{9}{2}{104} \subsecentry{\code {@print{\tt\char 123}{\tt\char 125}} (\print{}): Indicating Printed Output}{13}{9}{3}{104} \subsecentry{\code {@error{\tt\char 123}{\tt\char 125}} (\error{}): Indicating an Error Message}{13}{9}{4}{104} \subsecentry{\code {@equiv{\tt\char 123}{\tt\char 125}} (\equiv{}): Indicating Equivalence}{13}{9}{5}{105} \subsecentry{\code {@point{\tt\char 123}{\tt\char 125}} (\point{}): Indicating Point in a Buffer}{13}{9}{6}{105} \secentry{Footnotes}{13}{10}{106} \subsecentry{Footnote Commands}{13}{10}{1}{106} \subsecentry{Footnote Styles}{13}{10}{2}{107} \secentry{Inserting Images}{13}{11}{108} \chapentry{Making and Preventing Breaks}{14}{109} \secentry{\code {@*}: Generate Line Breaks}{14}{1}{109} \secentry{\code {@-} and \code {@hyphenation}: Helping \TeX{} hyphenate}{14}{2}{110} \secentry{\code {@w}{\tt\char 123}\var {text}{\tt\char 125}: Prevent Line Breaks}{14}{3}{110} \secentry{\code {@sp} \var {n}: Insert Blank Lines}{14}{4}{110} \secentry{\code {@page}: Start a New Page}{14}{5}{111} \secentry{\code {@group}: Prevent Page Breaks}{14}{6}{111} \secentry{\code {@need \var {mils}}: Prevent Page Breaks}{14}{7}{111} \chapentry{Definition Commands}{15}{112} \secentry{The Template for a Definition}{15}{1}{112} \secentry{Optional and Repeated Arguments}{15}{2}{113} \secentry{Two or More `First' Lines}{15}{3}{114} \secentry{The Definition Commands}{15}{4}{114} \subsecentry{Functions and Similar Entities}{15}{4}{1}{114} \subsecentry{Variables and Similar Entities}{15}{4}{2}{116} \subsecentry{Functions in Typed Languages}{15}{4}{3}{117} \subsecentry{Variables in Typed Languages}{15}{4}{4}{118} \subsecentry{Object-Oriented Programming}{15}{4}{5}{119} \subsecentry{Data Types}{15}{4}{6}{122} \secentry{Conventions for Writing Definitions}{15}{5}{122} \secentry{A Sample Function Definition}{15}{6}{122} \chapentry{Conditionally Visible Text}{16}{124} \secentry{Conditional Commands}{16}{1}{124} \secentry{Conditional Not Commands}{16}{2}{124} \secentry{Raw Formatter Commands}{16}{3}{125} \secentry{\code {@set}, \code {@clear}, and \code {@value}}{16}{4}{126} \subsecentry{\code {@ifset} and \code {@ifclear}}{16}{4}{1}{126} \subsecentry{\code {@set} and \code {@value}}{16}{4}{2}{127} \subsecentry{\code {@value} Example}{16}{4}{3}{128} \chapentry{Internationalization}{17}{130} \secentry{\code {@documentlanguage \var {cc}}: Set the Document Language}{17}{1}{130} \secentry{\code {@documentencoding \var {enc}}: Set Input Encoding}{17}{2}{131} \chapentry{Defining New Texinfo Commands}{18}{132} \secentry{Defining Macros}{18}{1}{132} \secentry{Invoking Macros}{18}{2}{133} \secentry{Macro Details}{18}{3}{134} \secentry{\samp {@alias \var {new}=\var {existing}}}{18}{4}{134} \secentry{\samp {definfoenclose}: Customized Highlighting}{18}{5}{135} \chapentry{Formatting and Printing Hardcopy}{19}{136} \secentry{Use \TeX{}}{19}{1}{136} \secentry{Format with \code {tex} and \code {texindex}}{19}{2}{136} \secentry{Format with \code {texi2dvi}}{19}{3}{138} \secentry{Shell Print Using \code {lpr -d}}{19}{4}{138} \secentry{From an Emacs Shell}{19}{5}{139} \secentry{Formatting and Printing in Texinfo Mode}{19}{6}{139} \secentry{Using the Local Variables List}{19}{7}{141} \secentry{\TeX{} Formatting Requirements Summary}{19}{8}{141} \secentry{Preparing for \TeX{}}{19}{9}{142} \secentry{Overfull ``hboxes''}{19}{10}{143} \secentry{Printing ``Small'' Books}{19}{11}{144} \secentry{Printing on A4 Paper}{19}{12}{144} \secentry{\code {@pagesizes} [\var {width}][, \var {height}]: Custom page sizes}{19}{13}{144} \secentry{Cropmarks and Magnification}{19}{14}{145} \secentry{PDF Output}{19}{15}{146} \chapentry{Creating and Installing Info Files}{20}{147} \secentry{Creating an Info File}{20}{1}{147} \subsecentry{\code {makeinfo} Preferred}{20}{1}{1}{147} \subsecentry{Running \code {makeinfo} from a Shell}{20}{1}{2}{147} \subsecentry{Options for \code {makeinfo}}{20}{1}{3}{147} \subsecentry{Pointer Validation}{20}{1}{4}{150} \subsecentry{Running \code {makeinfo} inside Emacs}{20}{1}{5}{151} \subsecentry{The \code {texinfo-format\dots {}} Commands}{20}{1}{6}{152} \subsecentry{Batch Formatting}{20}{1}{7}{153} \subsecentry{Tag Files and Split Files}{20}{1}{8}{153} \subsecentry{Generating HTML}{20}{1}{9}{154} \secentry{Installing an Info File}{20}{2}{155} \subsecentry{The Directory File \file {dir}}{20}{2}{1}{155} \subsecentry{Listing a New Info File}{20}{2}{2}{156} \subsecentry{Info Files in Other Directories}{20}{2}{3}{156} \subsecentry{Installing Info Directory Files}{20}{2}{4}{157} \subsecentry{Invoking install-info}{20}{2}{5}{158} \chapentry{@-Command List}{Appendix{} A}{160} \chapentry{Tips and Hints}{Appendix{} B}{178} \chapentry{A Sample Texinfo File}{Appendix{} C}{183} \chapentry{Sample Permissions}{Appendix{} D}{185} \secentry{\samp {ifinfo} Copying Permissions}{D}{1}{185} \secentry{Titlepage Copying Permissions}{D}{2}{186} \chapentry{Include Files}{Appendix{} E}{187} \secentry{How to Use Include Files}{E}{1}{187} \secentry{\code {texinfo-multiple-files-update}}{E}{2}{187} \secentry{Include File Requirements}{E}{3}{188} \secentry{Sample File with \code {@include}}{E}{4}{188} \secentry{Evolution of Include Files}{E}{5}{189} \chapentry{Page Headings}{Appendix{} F}{191} \secentry{Standard Heading Formats}{F}{1}{191} \secentry{Specifying the Type of Heading}{F}{2}{192} \secentry{How to Make Your Own Headings}{F}{3}{193} \chapentry{Formatting Mistakes}{Appendix{} G}{195} \secentry{Catching Errors with Info Formatting}{G}{1}{195} \secentry{Catching Errors with \TeX{} Formatting}{G}{2}{196} \secentry{Using \code {texinfo-show-structure}}{G}{3}{198} \secentry{Using \code {occur}}{G}{4}{199} \secentry{Finding Badly Referenced Nodes}{G}{5}{200} \subsecentry{Running \code {Info-validate}}{G}{5}{1}{200} \subsecentry{Creating an Unsplit File}{G}{5}{2}{200} \subsecentry{Tagifying a File}{G}{5}{3}{201} \subsecentry{Splitting a File Manually}{G}{5}{4}{201} \chapentry{Refilling Paragraphs}{Appendix{} H}{203} \chapentry{@-Command Syntax}{Appendix{} I}{204} \chapentry{How to Obtain \TeX{}}{Appendix{} J}{205} \unnumbchapentry{Command and Variable Index}{206} \unnumbchapentry{Concept Index}{211}