This is texinfo.info, produced by texi2any version 6.0 from texinfo.texi. This manual is for GNU Texinfo (version 6.0, 26 June 2015), a documentation system that can produce both online information and a printed manual from a single source using semantic markup. Copyright (C) 1988, 1990, 1991, 1992, 1993, 1995, 1996, 1997, 1998, 1999, 2001, 2001, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015 Free Software Foundation, Inc. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, with the Front-Cover Texts being "A GNU Manual", and with the Back-Cover Texts as in (a) below. A copy of the license is included in the section entitled "GNU Free Documentation License". (a) The FSF's Back-Cover Text is: "You have the freedom to copy and modify this GNU manual. Buying copies from the FSF supports it in developing GNU and promoting software freedom." INFO-DIR-SECTION Texinfo documentation system START-INFO-DIR-ENTRY * Texinfo: (texinfo). The GNU documentation format. * install-info: (texinfo)Invoking install-info. Update info/dir entries. * makeinfo: (texinfo)Invoking makeinfo. Translate Texinfo source. * pod2texi: (pod2texi)Invoking pod2texi. Translate Perl POD to Texinfo. * texi2dvi: (texinfo)Format with texi2dvi. Print Texinfo documents. * texi2pdf: (texinfo)PDF Output. PDF output for Texinfo. * pdftexi2dvi: (texinfo)PDF Output. PDF output for Texinfo. * texindex: (texinfo)Format with tex/texindex. Sort Texinfo index files. END-INFO-DIR-ENTRY  Indirect: texinfo.info-1: 1778 texinfo.info-2: 302641 texinfo.info-3: 602977  Tag Table: (Indirect) Node: Top1778 Node: Copying Conditions28573 Node: Overview30477 Node: Reporting Bugs33298 Node: Using Texinfo34843 Node: Output Formats36336 Node: Adding Output Formats40986 Node: Texinfo Document Structure43426 Ref: Two Paths43610 Node: Info Files46240 Node: Printed Books48247 Node: Formatting Commands50267 Ref: Formatting Commands-Footnote-152499 Node: Conventions53108 Node: Comments56214 Node: Minimum57932 Node: Six Parts60489 Node: Short Sample62116 Node: History66260 Node: Texinfo Mode71294 Node: Texinfo Mode Overview72671 Node: Emacs Editing73441 Node: Inserting75582 Node: Showing the Structure79853 Node: Updating Nodes and Menus82121 Node: Updating Commands83200 Node: Updating Requirements89178 Node: Other Updating Commands91568 Node: Info Formatting94829 Node: Printing96095 Node: Texinfo Mode Summary98402 Node: Beginning a File103079 Node: Sample Beginning104378 Node: Texinfo File Header106005 Node: First Line107506 Node: Start of Header108537 Node: @setfilename109529 Ref: setfilename109735 Node: @settitle112584 Ref: settitle112778 Node: End of Header113998 Node: Document Permissions114283 Ref: Software Copying Permissions114763 Node: @copying115356 Ref: copying115538 Node: @insertcopying118011 Ref: insertcopying118199 Node: Titlepage & Copyright Page119221 Node: @titlepage120504 Ref: titlepage120648 Ref: @titlepage-Footnote-1122965 Node: @titlefont @center @sp123252 Ref: titlefont center sp123473 Node: @title @subtitle @author124938 Ref: title subtitle author125162 Node: Copyright127387 Node: Heading Generation129280 Ref: end titlepage129431 Node: Contents131000 Node: The Top Node134301 Node: Top Node Example135479 Node: Master Menu Parts135902 Node: Global Document Commands137780 Node: @documentdescription138646 Ref: documentdescription138842 Node: @setchapternewpage139465 Ref: setchapternewpage139705 Node: @headings142391 Ref: headings on off142575 Node: @paragraphindent144383 Ref: paragraphindent144630 Node: @firstparagraphindent145678 Ref: firstparagraphindent145922 Node: @exampleindent146946 Ref: exampleindent147145 Node: Ending a File148055 Node: Printing Indices & Menus148636 Node: File End151617 Node: Chapter Structuring152197 Ref: Structuring152338 Node: Tree Structuring153843 Node: Structuring Command Types155431 Node: @chapter157769 Ref: chapter157971 Node: @unnumbered @appendix159091 Ref: unnumbered & appendix159344 Node: @majorheading @chapheading160412 Ref: majorheading & chapheading160663 Node: @section161389 Ref: section161615 Node: @unnumberedsec @appendixsec @heading162569 Ref: unnumberedsec appendixsec heading162798 Node: @subsection164005 Ref: subsection164265 Node: @unnumberedsubsec @appendixsubsec @subheading164730 Ref: unnumberedsubsec appendixsubsec subheading164948 Node: @subsubsection165895 Ref: subsubsection166125 Node: @part167519 Node: Raise/lower sections169769 Node: Nodes172057 Node: @node173463 Ref: node173594 Node: Node Names176281 Ref: Node Line Tips176544 Node: Writing a Node178126 Node: Node Line Requirements180878 Node: First Node185036 Node: @top Command187227 Ref: top command187374 Ref: makeinfo top187374 Ref: makeinfo top command187374 Node: makeinfo Pointer Creation188214 Node: @anchor190036 Ref: anchor190268 Node: Node Menu Illustration192117 Node: Menus196596 Node: Menu Location197499 Node: Writing a Menu199141 Node: Menu Parts200655 Node: Less Cluttered Menu Entry202294 Node: Menu Example202905 Node: Other Info Files204416 Node: Cross References205785 Node: References206834 Node: Cross Reference Commands208669 Node: Cross Reference Parts209819 Node: @xref212974 Ref: xref213112 Node: Reference Syntax213853 Node: One Argument215643 Node: Two Arguments216866 Node: Three Arguments218289 Node: Four and Five Arguments220801 Node: Top Node Naming223502 Node: @ref225304 Ref: ref225424 Node: @pxref226892 Ref: pxref227009 Node: @inforef229473 Ref: inforef229674 Node: @url230987 Ref: uref231173 Ref: url231530 Node: @url Examples232462 Node: URL Line Breaking234072 Node: @url PDF Output Format235281 Node: PDF Colors236359 Node: @cite237636 Ref: cite237757 Node: Marking Text238086 Node: Indicating238751 Node: Useful Highlighting240251 Node: @code241916 Ref: code242065 Node: @kbd245686 Ref: kbd245834 Node: @key247590 Ref: key247716 Node: @samp249046 Ref: samp249167 Node: @verb250543 Ref: verb250680 Node: @var251823 Ref: var251977 Node: @env253633 Ref: env253783 Node: @file254148 Ref: file254282 Node: @command254760 Ref: command254911 Node: @option255466 Ref: option255612 Node: @dfn255908 Ref: dfn256031 Node: @abbr256835 Ref: abbr256999 Node: @acronym258255 Ref: acronym258423 Node: @indicateurl261066 Ref: indicateurl261255 Node: @email261809 Ref: email261983 Node: Emphasis262667 Node: @emph @strong263501 Ref: emph & strong263659 Node: Smallcaps264537 Node: Fonts265674 Node: Quotations and Examples268380 Node: Block Enclosing Commands270269 Node: @quotation272575 Ref: quotation272775 Node: @indentedblock275066 Node: @example276037 Ref: example276208 Node: @verbatim278330 Ref: verbatim278505 Node: @verbatiminclude280168 Ref: verbatiminclude280386 Node: @lisp281269 Ref: lisp281453 Ref: @lisp-Footnote-1282011 Node: @small...282130 Ref: small282296 Node: @display284003 Ref: display284199 Node: @format285008 Ref: format285214 Node: @exdent285667 Ref: exdent285875 Node: @flushleft @flushright286804 Ref: flushleft & flushright286999 Node: @raggedright288084 Ref: raggedright288287 Node: @noindent289367 Ref: noindent289555 Node: @indent291224 Ref: indent291404 Node: @cartouche292363 Ref: cartouche292529 Node: Lists and Tables293322 Node: Introducing Lists294011 Node: @itemize295672 Ref: itemize295862 Node: @enumerate298328 Ref: enumerate298544 Node: Two-column Tables302641 Node: @table303329 Ref: table303483 Ref: @asis304166 Node: @ftable @vtable306099 Ref: ftable vtable306262 Node: @itemx307200 Ref: itemx307376 Node: Multi-column Tables308438 Node: Multitable Column Widths309147 Node: Multitable Rows310628 Node: Special Displays313050 Node: Floats313839 Node: @float314726 Ref: float314908 Ref: fig:ex1315409 Node: @caption @shortcaption316682 Ref: caption shortcaption316858 Node: @listoffloats318361 Ref: listoffloats318558 Node: Images319863 Node: Image Syntax320298 Node: Image Scaling324295 Node: Footnotes326022 Ref: Footnotes-Footnote-1326643 Node: Footnote Commands326924 Ref: Footnote Commands-Footnote-1329126 Node: Footnote Styles329163 Node: Indices331795 Node: Index Entries333009 Node: Predefined Indices334109 Node: Indexing Commands336213 Node: Combining Indices339551 Node: @syncodeindex340905 Ref: syncodeindex341104 Node: @synindex342616 Ref: synindex342779 Node: New Indices343192 Node: Insertions345523 Node: Special Characters346620 Ref: Braces Atsign346814 Ref: Atsign Braces Comma346814 Node: Inserting an Atsign347480 Node: Inserting Braces348073 Node: Inserting a Comma348785 Node: Inserting a Backslash349999 Node: Inserting a Hashsign351239 Node: Inserting Quote Characters352466 Node: Inserting Space354225 Node: Multiple Spaces354814 Node: Not Ending a Sentence355917 Node: Ending a Sentence357794 Node: @frenchspacing360093 Ref: frenchspacing360308 Node: @dmn361471 Ref: dmn361642 Node: Inserting Accents362617 Node: Inserting Quotation Marks365341 Node: Inserting Subscripts and Superscripts369182 Node: Inserting Math370433 Ref: math370664 Node: Glyphs for Text372906 Ref: Glyphs373066 Ref: TeX and copyright373066 Node: @TeX @LaTeX374009 Ref: tex374183 Node: @copyright374816 Ref: copyright symbol374982 Node: @registeredsymbol375260 Ref: registered symbol375434 Node: @dots375588 Ref: dots375773 Ref: Dots Bullets375773 Node: @bullet376590 Ref: bullet376721 Node: @euro377003 Ref: euro377182 Node: @pounds378272 Ref: pounds378443 Node: @textdegree378590 Ref: textdegree378768 Node: @minus378900 Ref: minus379086 Node: @geq @leq380024 Ref: geq leq380216 Node: Glyphs for Programming380417 Node: Glyphs Summary381659 Node: @result382371 Ref: result382579 Node: @expansion382916 Ref: expansion383124 Node: @print383909 Ref: Print Glyph384114 Node: @error384824 Ref: Error Glyph385035 Node: @equiv385764 Ref: Equivalence385955 Node: @point386534 Ref: Point Glyph386748 Node: Click Sequences388145 Node: Inserting Unicode389164 Node: Breaks391089 Node: Break Commands392518 Node: Line Breaks393386 Node: @- @hyphenation394138 Ref: - and hyphenation394347 Node: @allowcodebreaks395468 Ref: allowcodebreaks395676 Node: @w396680 Ref: w396839 Node: @tie397841 Ref: tie398005 Node: @sp398747 Ref: sp398888 Node: @page399169 Ref: page399308 Node: @group399563 Ref: group399712 Node: @need401319 Ref: need401464 Node: Definition Commands402070 Node: Def Cmd Template403729 Node: Def Cmd Continuation Lines406446 Node: Optional Arguments408061 Node: @deffnx409503 Ref: deffnx409722 Node: Def Cmds in Detail410486 Node: Functions Commands411605 Node: Variables Commands414459 Node: Typed Functions416603 Node: Typed Variables420554 Node: Data Types422273 Node: Abstract Objects423559 Node: Object-Oriented Variables424168 Node: Object-Oriented Methods426801 Node: Def Cmd Conventions430734 Node: Sample Function Definition431305 Node: Internationalization434123 Node: @documentlanguage434783 Ref: documentlanguage435005 Node: @documentencoding437821 Ref: documentencoding438021 Node: Conditionals441171 Node: Conditional Commands442542 Node: Conditional Not Commands445376 Node: Raw Formatter Commands446660 Node: Inline Conditionals450220 Node: @set @clear @value452134 Ref: set clear value452382 Node: @set @value453611 Ref: set value453757 Node: @ifset @ifclear455741 Ref: ifset ifclear455931 Node: @inlineifset @inlineifclear457893 Node: @value Example458683 Ref: value Example458838 Node: Testing for Texinfo Commands460848 Node: Conditional Nesting463421 Node: Defining New Texinfo Commands464975 Node: Defining Macros466608 Node: Invoking Macros469112 Node: Macro Details473149 Node: @alias478668 Ref: alias478842 Node: @definfoenclose480358 Ref: definfoenclose480586 Node: External Macro Processors483179 Node: #line Directive484497 Node: #line and TeX485948 Node: #line Syntax Details487425 Node: Include Files488681 Node: Using Include Files489681 Node: texinfo-multiple-files-update490950 Node: Include Files Requirements493313 Node: Sample Include File494569 Node: Include Files Evolution495808 Node: Hardcopy497791 Node: Use TeX500082 Node: Format with texi2dvi500538 Node: Format with tex/texindex503854 Ref: Names of index files504824 Node: Formatting Partial Documents507290 Node: Details of texindex508432 Node: Print with lpr510544 Node: Within Emacs511828 Node: Texinfo Mode Printing512788 Node: Compile-Command516447 Node: Requirements Summary517313 Node: Preparing for TeX518574 Node: Overfull hboxes522295 Node: @smallbook524412 Ref: smallbook524596 Node: A4 Paper525633 Node: @pagesizes526554 Ref: pagesizes526776 Node: Cropmarks and Magnification527650 Node: PDF Output529737 Node: Obtaining TeX531410 Node: Generic Translator texi2any531820 Node: Reference Implementation533536 Node: Invoking texi2any535822 Ref: Invoking makeinfo536068 Ref: makeinfo Options536603 Ref: texi2any Options536603 Ref: Splitting Output549674 Node: texi2any Printed Output551999 Node: Pointer Validation554115 Node: Customization Variables555761 Node: Customization Variables for @-Commands557321 Node: Customization Variables and Options558808 Node: HTML Customization Variables562567 Node: Other Customization Variables573789 Node: Internationalization of Document Strings587126 Node: Invoking pod2texi590975 Node: texi2html592187 Node: Creating and Installing Info Files595378 Node: Creating an Info File595791 Node: makeinfo Advantages596804 Ref: makeinfo advantages596967 Node: makeinfo in Emacs597486 Node: texinfo-format commands599936 Node: Batch Formatting602977 Node: Tag and Split Files604170 Node: Installing an Info File607572 Node: Directory File608407 Node: New Info File610205 Ref: New Info File-Footnote-1611320 Node: Other Info Directories611402 Node: Installing Dir Entries615511 Node: Invoking install-info618710 Node: Generating HTML625424 Node: HTML Translation626359 Node: HTML Splitting629674 Node: HTML CSS632121 Node: HTML Xref636098 Node: HTML Xref Link Basics637417 Node: HTML Xref Node Name Expansion640663 Node: HTML Xref Command Expansion643635 Node: HTML Xref 8-bit Character Expansion646762 Node: HTML Xref Mismatch649155 Node: HTML Xref Configuration650856 Node: HTML Xref Link Preservation654476 Node: Command List656332 Node: Command Syntax701553 Node: Command Contexts704637 Node: Tips706499 Ref: texi-elements-by-size715922 Node: Sample Texinfo Files717728 Node: Short Sample Texinfo File718189 Node: GNU Sample Texts719857 Node: Verbatim Copying License725102 Node: All-permissive Copying License726202 Node: Headings727241 Node: Headings Introduced727906 Node: Heading Format729783 Node: Heading Choice732227 Node: Custom Headings733573 Node: Catching Mistakes739238 Node: makeinfo Preferred740546 Node: Debugging with Info741427 Node: Debugging with TeX744770 Node: Using texinfo-show-structure748996 Node: Using occur752076 Node: Running Info-validate753617 Ref: Running Info-Validate753784 Node: Using Info-validate754681 Node: Unsplit756486 Node: Tagifying757543 Node: Splitting758402 Node: Info Format Specification760030 Node: Info Format General Layout761695 Node: Info Format Whole Manual762250 Node: Info Format Preamble763214 Node: Info Format Indirect Table764171 Node: Info Format Tag Table765705 Node: Info Format Local Variables767290 Node: Info Format Regular Nodes767770 Node: Info Format Text Constructs769892 Node: Info Format Menu770292 Node: Info Format Image771149 Node: Info Format Printindex772405 Node: Info Format Cross Reference773569 Node: GNU Free Documentation License775596 Node: Command and Variable Index800774 Node: General Index844363  End Tag Table