|
DataMuseum.dkPresents historical artifacts from the history of: DKUUG/EUUG Conference tapes |
This is an automatic "excavation" of a thematic subset of
See our Wiki for more about DKUUG/EUUG Conference tapes Excavated with: AutoArchaeologist - Free & Open Source Software. |
top - downloadIndex: ┃ t ┃
Length: 47423 (0xb93f)
Names: »texinfo«
└─⟦a0efdde77⟧ Bits:30001252 EUUGD11 Tape, 1987 Spring Conference Helsinki
└─ ⟦this⟧ »EUUGD11/gnu-31mar87/emacs/info/texinfo«
0x0000…0020 49 6e 66 6f 20 66 69 6c 65 20 74 65 78 69 6e 66 6f 2c 20 70 72 6f 64 75 63 65 64 20 62 79 20 74 ┆Info file texinfo, produced by t┆
0x0020…0040 65 78 69 6e 66 6f 2d 66 6f 72 6d 61 74 2d 62 75 66 66 65 72 20 20 20 2d 2a 2d 54 65 78 74 2d 2a ┆exinfo-format-buffer -*-Text-*┆
0x0040…0060 2d 0a 66 72 6f 6d 20 66 69 6c 65 20 74 65 78 69 6e 66 6f 2e 74 65 78 69 6e 66 6f 0a 0a 0a 0a 44 ┆- from file texinfo.texinfo D┆
0x0060…0080 69 73 74 72 69 62 75 74 69 6f 6e 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 0a 0a 43 6f 70 79 72 69 ┆istribution ************ Copyri┆
0x0080…00a0 67 68 74 20 28 43 29 20 31 39 38 35 20 52 69 63 68 61 72 64 20 4d 2e 20 53 74 61 6c 6c 6d 61 6e ┆ght (C) 1985 Richard M. Stallman┆
0x00a0…00c0 2e 0a 0a 50 65 72 6d 69 73 73 69 6f 6e 20 69 73 20 67 72 61 6e 74 65 64 20 74 6f 20 6d 61 6b 65 ┆. Permission is granted to make┆
0x00c0…00e0 20 61 6e 64 20 64 69 73 74 72 69 62 75 74 65 20 76 65 72 62 61 74 69 6d 20 63 6f 70 69 65 73 20 ┆ and distribute verbatim copies ┆
0x00e0…0100 6f 66 0a 74 68 69 73 20 6d 61 6e 75 61 6c 20 70 72 6f 76 69 64 65 64 20 74 68 65 20 63 6f 70 79 ┆of this manual provided the copy┆
0x0100…0120 72 69 67 68 74 20 6e 6f 74 69 63 65 20 61 6e 64 20 74 68 69 73 20 70 65 72 6d 69 73 73 69 6f 6e ┆right notice and this permission┆
0x0120…0140 20 6e 6f 74 69 63 65 0a 61 72 65 20 70 72 65 73 65 72 76 65 64 20 6f 6e 20 61 6c 6c 20 63 6f 70 ┆ notice are preserved on all cop┆
0x0140…0160 69 65 73 2e 0a 0a 50 65 72 6d 69 73 73 69 6f 6e 20 69 73 20 67 72 61 6e 74 65 64 20 74 6f 20 63 ┆ies. Permission is granted to c┆
0x0160…0180 6f 70 79 20 61 6e 64 20 64 69 73 74 72 69 62 75 74 65 20 6d 6f 64 69 66 69 65 64 20 76 65 72 73 ┆opy and distribute modified vers┆
0x0180…01a0 69 6f 6e 73 20 6f 66 20 74 68 69 73 0a 6d 61 6e 75 61 6c 20 75 6e 64 65 72 20 74 68 65 20 63 6f ┆ions of this manual under the co┆
0x01a0…01c0 6e 64 69 74 69 6f 6e 73 20 66 6f 72 20 76 65 72 62 61 74 69 6d 20 63 6f 70 79 69 6e 67 2c 20 70 ┆nditions for verbatim copying, p┆
0x01c0…01e0 72 6f 76 69 64 65 64 20 74 68 61 74 20 74 68 65 20 65 6e 74 69 72 65 0a 72 65 73 75 6c 74 69 6e ┆rovided that the entire resultin┆
0x01e0…0200 67 20 64 65 72 69 76 65 64 20 77 6f 72 6b 20 69 73 20 64 69 73 74 72 69 62 75 74 65 64 20 75 6e ┆g derived work is distributed un┆
0x0200…0220 64 65 72 20 74 68 65 20 74 65 72 6d 73 20 6f 66 20 61 20 70 65 72 6d 69 73 73 69 6f 6e 0a 6e 6f ┆der the terms of a permission no┆
0x0220…0240 74 69 63 65 20 69 64 65 6e 74 69 63 61 6c 20 74 6f 20 74 68 69 73 20 6f 6e 65 2e 0a 0a 50 65 72 ┆tice identical to this one. Per┆
0x0240…0260 6d 69 73 73 69 6f 6e 20 69 73 20 67 72 61 6e 74 65 64 20 74 6f 20 63 6f 70 79 20 61 6e 64 20 64 ┆mission is granted to copy and d┆
0x0260…0280 69 73 74 72 69 62 75 74 65 20 74 72 61 6e 73 6c 61 74 69 6f 6e 73 20 6f 66 20 74 68 69 73 20 6d ┆istribute translations of this m┆
0x0280…02a0 61 6e 75 61 6c 0a 69 6e 74 6f 20 61 6e 6f 74 68 65 72 20 6c 61 6e 67 75 61 67 65 2c 20 75 6e 64 ┆anual into another language, und┆
0x02a0…02c0 65 72 20 74 68 65 20 73 61 6d 65 20 63 6f 6e 64 69 74 69 6f 6e 73 20 61 73 20 66 6f 72 20 6d 6f ┆er the same conditions as for mo┆
0x02c0…02e0 64 69 66 69 65 64 20 76 65 72 73 69 6f 6e 73 2e 0a 0a 1f 0a 46 69 6c 65 3a 20 74 65 78 69 6e 66 ┆dified versions. File: texinf┆
0x02e0…0300 6f 20 20 4e 6f 64 65 3a 20 74 6f 70 2c 20 55 70 3a 20 28 44 49 52 29 2c 20 4e 65 78 74 3a 20 63 ┆o Node: top, Up: (DIR), Next: c┆
0x0300…0320 6f 6d 6d 61 6e 64 73 0a 0a 54 65 78 69 6e 66 6f 20 46 69 6c 65 73 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a ┆ommands Texinfo Files *********┆
0x0320…0340 2a 2a 2a 2a 0a 0a 44 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 66 6f 72 20 47 4e 55 20 75 74 69 6c ┆**** Documentation for GNU util┆
0x0340…0360 69 74 69 65 73 20 61 6e 64 20 6c 69 62 72 61 72 69 65 73 20 73 68 6f 75 6c 64 20 62 65 20 77 72 ┆ities and libraries should be wr┆
0x0360…0380 69 74 74 65 6e 20 69 6e 20 61 20 66 6f 72 6d 61 74 0a 63 61 6c 6c 65 64 20 22 74 65 78 69 6e 66 ┆itten in a format called "texinf┆
0x0380…03a0 6f 22 2e 20 20 54 68 69 73 20 66 6f 72 6d 61 74 20 63 61 6e 20 62 65 20 74 72 61 6e 73 6c 61 74 ┆o". This format can be translat┆
0x03a0…03c0 65 64 20 6d 65 63 68 61 6e 69 63 61 6c 6c 79 20 69 6e 74 6f 20 65 69 74 68 65 72 0a 70 72 69 6e ┆ed mechanically into either prin┆
0x03c0…03e0 74 65 64 20 6d 61 6e 75 61 6c 73 20 6f 72 20 6f 6e 2d 6c 69 6e 65 20 72 65 61 64 61 62 6c 65 20 ┆ted manuals or on-line readable ┆
0x03e0…0400 49 6e 66 6f 20 66 69 6c 65 73 2e 0a 0a 2a 20 4d 65 6e 75 3a 0a 0a 2a 20 69 6e 66 6f 3a 3a 20 20 ┆Info files. * Menu: * info:: ┆
0x0400…0420 20 20 20 20 20 57 68 61 74 20 49 6e 66 6f 20 66 69 6c 65 73 20 64 6f 2e 0a 2a 20 63 6f 6d 6d 61 ┆ What Info files do. * comma┆
0x0420…0440 6e 64 73 3a 3a 20 20 20 57 68 61 74 20 67 6f 65 73 20 69 6e 74 6f 20 61 20 74 65 78 69 6e 66 6f ┆nds:: What goes into a texinfo┆
0x0440…0460 20 66 69 6c 65 2e 0a 2a 20 6d 61 6b 65 2d 69 6e 66 6f 3a 3a 20 20 4d 61 6b 69 6e 67 20 61 20 74 ┆ file. * make-info:: Making a t┆
0x0460…0480 65 78 69 6e 66 6f 20 66 69 6c 65 20 69 6e 74 6f 20 61 6e 20 49 6e 66 6f 20 66 69 6c 65 2e 0a 2a ┆exinfo file into an Info file. *┆
0x0480…04a0 20 6d 61 6e 75 61 6c 3a 3a 20 20 20 20 20 4d 61 6b 69 6e 67 20 61 20 74 65 78 69 6e 66 6f 20 66 ┆ manual:: Making a texinfo f┆
0x04a0…04c0 69 6c 65 20 69 6e 74 6f 20 61 20 70 72 69 6e 74 65 64 20 6d 61 6e 75 61 6c 2e 0a 0a 1f 0a 46 69 ┆ile into a printed manual. Fi┆
0x04c0…04e0 6c 65 3a 20 74 65 78 69 6e 66 6f 20 20 4e 6f 64 65 3a 20 69 6e 66 6f 2c 20 50 72 65 76 3a 20 74 ┆le: texinfo Node: info, Prev: t┆
0x04e0…0500 6f 70 2c 20 55 70 3a 20 74 6f 70 2c 20 4e 65 78 74 3a 20 63 6f 6d 6d 61 6e 64 73 0a 0a 57 68 61 ┆op, Up: top, Next: commands Wha┆
0x0500…0520 74 20 49 6e 66 6f 20 46 69 6c 65 73 20 44 6f 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ┆t Info Files Do ================┆
0x0520…0540 3d 3d 0a 0a 41 6e 20 49 6e 66 6f 20 66 69 6c 65 20 69 73 20 61 20 66 69 6c 65 20 66 6f 72 6d 61 ┆== An Info file is a file forma┆
0x0540…0560 74 74 65 64 20 73 6f 20 74 68 61 74 20 74 68 65 20 49 6e 66 6f 20 64 6f 63 75 6d 65 6e 74 61 74 ┆tted so that the Info documentat┆
0x0560…0580 69 6f 6e 20 72 65 61 64 69 6e 67 0a 70 72 6f 67 72 61 6d 20 63 61 6e 20 6f 70 65 72 61 74 65 20 ┆ion reading program can operate ┆
0x0580…05a0 6f 6e 20 69 74 2e 20 20 49 6e 66 6f 20 66 69 6c 65 73 20 61 72 65 20 64 69 76 69 64 65 64 20 69 ┆on it. Info files are divided i┆
0x05a0…05c0 6e 74 6f 20 70 69 65 63 65 73 20 63 61 6c 6c 65 64 0a 22 6e 6f 64 65 73 22 2c 20 65 61 63 68 20 ┆nto pieces called "nodes", each ┆
0x05c0…05e0 6f 66 20 77 68 69 63 68 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 64 69 73 63 75 73 73 69 6f 6e ┆of which contains the discussion┆
0x05e0…0600 20 6f 66 20 6f 6e 65 20 74 6f 70 69 63 2e 20 20 45 61 63 68 20 6e 6f 64 65 0a 68 61 73 20 61 20 ┆ of one topic. Each node has a ┆
0x0600…0620 6e 61 6d 65 2c 20 61 6e 64 20 63 6f 6e 74 61 69 6e 73 20 62 6f 74 68 20 74 65 78 74 20 66 6f 72 ┆name, and contains both text for┆
0x0620…0640 20 74 68 65 20 75 73 65 72 20 74 6f 20 72 65 61 64 20 61 6e 64 20 70 6f 69 6e 74 65 72 73 20 74 ┆ the user to read and pointers t┆
0x0640…0660 6f 0a 6f 74 68 65 72 20 6e 6f 64 65 73 2c 20 77 68 69 63 68 20 61 72 65 20 69 64 65 6e 74 69 66 ┆o other nodes, which are identif┆
0x0660…0680 69 65 64 20 62 79 20 74 68 65 69 72 20 6e 61 6d 65 73 2e 20 20 49 6e 66 6f 20 64 69 73 70 6c 61 ┆ied by their names. Info displa┆
0x0680…06a0 79 73 20 6f 6e 65 20 6e 6f 64 65 0a 61 74 20 61 20 74 69 6d 65 2c 20 61 6e 64 20 70 72 6f 76 69 ┆ys one node at a time, and provi┆
0x06a0…06c0 64 65 73 20 63 6f 6d 6d 61 6e 64 73 20 77 69 74 68 20 77 68 69 63 68 20 74 68 65 20 75 73 65 72 ┆des commands with which the user┆
0x06c0…06e0 20 63 61 6e 20 6d 6f 76 65 20 74 6f 20 74 68 65 20 6f 74 68 65 72 0a 6e 6f 64 65 73 20 74 68 61 ┆ can move to the other nodes tha┆
0x06e0…0700 74 20 74 68 65 20 63 75 72 72 65 6e 74 20 6e 6f 64 65 20 70 6f 69 6e 74 73 20 74 6f 2e 0a 0a 4e ┆t the current node points to. N┆
0x0700…0720 6f 72 6d 61 6c 6c 79 20 6d 6f 73 74 20 6f 66 20 74 68 65 20 6e 6f 64 65 73 20 61 72 65 20 61 72 ┆ormally most of the nodes are ar┆
0x0720…0740 72 61 6e 67 65 64 20 69 6e 20 61 20 74 72 65 65 20 77 68 69 63 68 20 62 72 61 6e 63 68 65 73 20 ┆ranged in a tree which branches ┆
0x0740…0760 64 6f 77 6e 2e 0a 45 61 63 68 20 6e 6f 64 65 20 6d 61 79 20 68 61 76 65 20 61 6e 79 20 6e 75 6d ┆down. Each node may have any num┆
0x0760…0780 62 65 72 20 6f 66 20 63 68 69 6c 64 20 6e 6f 64 65 73 20 74 68 61 74 20 64 65 73 63 72 69 62 65 ┆ber of child nodes that describe┆
0x0780…07a0 20 73 75 62 74 6f 70 69 63 73 20 6f 66 20 74 68 65 0a 6e 6f 64 65 27 73 20 74 6f 70 69 63 2e 20 ┆ subtopics of the node's topic. ┆
0x07a0…07c0 20 54 68 65 20 6e 61 6d 65 73 20 6f 66 20 74 68 65 73 65 20 63 68 69 6c 64 20 6e 6f 64 65 73 2c ┆ The names of these child nodes,┆
0x07c0…07e0 20 69 66 20 61 6e 79 2c 20 61 72 65 20 6c 69 73 74 65 64 20 69 6e 20 61 0a 22 6d 65 6e 75 22 20 ┆ if any, are listed in a "menu" ┆
0x07e0…0800 77 69 74 68 69 6e 20 74 68 65 20 70 61 72 65 6e 74 20 6e 6f 64 65 3b 20 74 68 69 73 20 61 6c 6c ┆within the parent node; this all┆
0x0800…0820 6f 77 73 20 63 65 72 74 61 69 6e 20 49 6e 66 6f 20 63 6f 6d 6d 61 6e 64 73 20 74 6f 0a 62 65 20 ┆ows certain Info commands to be ┆
0x0820…0840 75 73 65 64 20 74 6f 20 6d 6f 76 65 20 74 6f 20 6f 6e 65 20 6f 66 20 74 68 65 20 63 68 69 6c 64 ┆used to move to one of the child┆
0x0840…0860 20 6e 6f 64 65 73 2e 20 20 45 61 63 68 20 63 68 69 6c 64 20 6e 6f 64 65 20 72 65 63 6f 72 64 73 ┆ nodes. Each child node records┆
0x0860…0880 20 74 68 65 0a 70 61 72 65 6e 74 20 6e 6f 64 65 20 6e 61 6d 65 2c 20 61 73 20 69 74 73 20 60 75 ┆ the parent node name, as its `u┆
0x0880…08a0 70 27 20 70 6f 69 6e 74 65 72 2e 0a 0a 41 6c 6c 20 74 68 65 20 63 68 69 6c 64 72 65 6e 20 6f 66 ┆p' pointer. All the children of┆
0x08a0…08c0 20 61 6e 79 20 6f 6e 65 20 70 61 72 65 6e 74 20 61 72 65 20 6c 69 6e 6b 65 64 20 74 6f 67 65 74 ┆ any one parent are linked toget┆
0x08c0…08e0 68 65 72 20 69 6e 20 61 20 62 69 64 69 72 65 63 74 69 6f 6e 61 6c 0a 63 68 61 69 6e 20 6f 66 20 ┆her in a bidirectional chain of ┆
0x08e0…0900 60 6e 65 78 74 27 20 61 6e 64 20 60 70 72 65 76 69 6f 75 73 27 20 70 6f 69 6e 74 65 72 73 2e 20 ┆`next' and `previous' pointers. ┆
0x0900…0920 20 4e 6f 72 6d 61 6c 6c 79 20 74 68 65 20 6f 72 64 65 72 20 69 6e 20 74 68 69 73 20 63 68 61 69 ┆ Normally the order in this chai┆
0x0920…0940 6e 0a 69 73 20 74 68 65 20 73 61 6d 65 20 61 73 20 74 68 65 20 6f 72 64 65 72 20 6f 66 20 74 68 ┆n is the same as the order of th┆
0x0940…0960 65 20 63 68 69 6c 64 72 65 6e 20 69 6e 20 74 68 65 20 70 61 72 65 6e 74 27 73 20 6d 65 6e 75 2e ┆e children in the parent's menu.┆
0x0960…0980 20 20 54 68 65 20 6c 61 73 74 0a 63 68 69 6c 64 20 68 61 73 20 6e 6f 20 60 6e 65 78 74 27 20 70 ┆ The last child has no `next' p┆
0x0980…09a0 6f 69 6e 74 65 72 2c 20 61 6e 64 20 74 68 65 20 66 69 72 73 74 20 63 68 69 6c 64 20 6e 6f 72 6d ┆ointer, and the first child norm┆
0x09a0…09c0 61 6c 6c 79 20 68 61 73 20 74 68 65 20 70 61 72 65 6e 74 20 61 73 0a 69 74 73 20 60 70 72 65 76 ┆ally has the parent as its `prev┆
0x09c0…09e0 69 6f 75 73 27 20 70 6f 69 6e 74 65 72 20 28 61 73 20 77 65 6c 6c 20 61 73 20 69 74 73 20 60 75 ┆ious' pointer (as well as its `u┆
0x09e0…0a00 70 27 20 70 6f 69 6e 74 65 72 2c 20 6f 66 20 63 6f 75 72 73 65 29 2e 0a 0a 54 68 65 20 72 6f 6f ┆p' pointer, of course). The roo┆
0x0a00…0a20 74 20 6f 66 20 74 68 65 20 74 72 65 65 20 69 73 20 74 68 65 20 74 6f 70 20 6e 6f 64 65 20 6f 66 ┆t of the tree is the top node of┆
0x0a20…0a40 20 74 68 65 20 66 69 6c 65 2c 20 74 68 72 6f 75 67 68 20 77 68 69 63 68 20 75 73 65 72 73 0a 65 ┆ the file, through which users e┆
0x0a40…0a60 6e 74 65 72 20 74 68 65 20 66 69 6c 65 20 66 72 6f 6d 20 74 68 65 20 49 6e 66 6f 20 64 69 72 65 ┆nter the file from the Info dire┆
0x0a60…0a80 63 74 6f 72 79 2e 20 20 42 79 20 63 6f 6e 76 65 6e 74 69 6f 6e 2c 20 74 68 69 73 20 6e 6f 64 65 ┆ctory. By convention, this node┆
0x0a80…0aa0 20 69 73 20 61 6c 77 61 79 73 0a 63 61 6c 6c 65 64 20 60 74 6f 70 27 2e 20 20 54 68 69 73 20 6e ┆ is always called `top'. This n┆
0x0aa0…0ac0 6f 64 65 20 6e 6f 72 6d 61 6c 6c 79 20 63 6f 6e 74 61 69 6e 73 20 6a 75 73 74 20 61 20 62 72 69 ┆ode normally contains just a bri┆
0x0ac0…0ae0 65 66 20 73 75 6d 6d 61 72 79 20 6f 66 20 74 68 65 0a 66 69 6c 65 27 73 20 70 75 72 70 6f 73 65 ┆ef summary of the file's purpose┆
0x0ae0…0b00 2c 20 61 6e 64 20 61 20 6c 61 72 67 65 20 6d 65 6e 75 20 74 68 72 6f 75 67 68 20 77 68 69 63 68 ┆, and a large menu through which┆
0x0b00…0b20 20 74 68 65 20 72 65 73 74 20 6f 66 20 74 68 65 20 66 69 6c 65 20 69 73 0a 72 65 61 63 68 65 64 ┆ the rest of the file is reached┆
0x0b20…0b40 2e 0a 0a 53 74 72 75 63 74 75 72 69 6e 67 20 74 68 65 20 6e 6f 64 65 73 20 69 6e 20 61 20 74 72 ┆. Structuring the nodes in a tr┆
0x0b40…0b60 65 65 20 69 73 20 61 20 6d 61 74 74 65 72 20 6f 66 20 63 6f 6e 76 65 6e 74 69 6f 6e 2c 20 6e 6f ┆ee is a matter of convention, no┆
0x0b60…0b80 74 20 61 0a 72 65 71 75 69 72 65 6d 65 6e 74 2e 20 20 49 6e 20 66 61 63 74 2c 20 74 68 65 20 60 ┆t a requirement. In fact, the `┆
0x0b80…0ba0 75 70 27 2c 20 60 70 72 65 76 69 6f 75 73 27 20 61 6e 64 20 60 6e 65 78 74 27 20 70 6f 69 6e 74 ┆up', `previous' and `next' point┆
0x0ba0…0bc0 65 72 73 20 6f 66 20 61 20 6e 6f 64 65 0a 63 61 6e 20 70 6f 69 6e 74 20 74 6f 20 61 6e 79 20 6f ┆ers of a node can point to any o┆
0x0bc0…0be0 74 68 65 72 20 6e 6f 64 65 73 2c 20 61 6e 64 20 74 68 65 20 6d 65 6e 75 20 63 61 6e 20 63 6f 6e ┆ther nodes, and the menu can con┆
0x0be0…0c00 74 61 69 6e 20 61 6e 79 20 6f 74 68 65 72 20 6e 6f 64 65 73 2e 0a 54 68 65 20 73 74 72 75 63 74 ┆tain any other nodes. The struct┆
0x0c00…0c20 75 72 65 20 6f 66 20 6e 6f 64 65 73 20 63 61 6e 20 62 65 20 61 6e 79 20 64 69 72 65 63 74 65 64 ┆ure of nodes can be any directed┆
0x0c20…0c40 20 67 72 61 70 68 2e 20 20 42 75 74 20 69 74 20 69 73 20 75 73 75 61 6c 6c 79 20 6d 6f 72 65 0a ┆ graph. But it is usually more ┆
0x0c40…0c60 63 6f 6d 70 72 65 68 65 6e 73 69 62 6c 65 20 74 6f 20 74 68 65 20 75 73 65 72 20 74 6f 20 6d 61 ┆comprehensible to the user to ma┆
0x0c60…0c80 6b 65 20 69 74 20 61 20 74 72 65 65 2e 20 20 49 6e 66 6f 20 70 72 6f 76 69 64 65 73 20 61 6e 6f ┆ke it a tree. Info provides ano┆
0x0c80…0ca0 74 68 65 72 20 6b 69 6e 64 0a 6f 66 20 70 6f 69 6e 74 65 72 20 62 65 74 77 65 65 6e 20 6e 6f 64 ┆ther kind of pointer between nod┆
0x0ca0…0cc0 65 73 2c 20 63 61 6c 6c 65 64 20 61 20 72 65 66 65 72 65 6e 63 65 2c 20 74 68 61 74 20 63 61 6e ┆es, called a reference, that can┆
0x0cc0…0ce0 20 62 65 20 73 70 72 69 6e 6b 6c 65 64 20 74 68 72 6f 75 67 68 0a 74 68 65 20 74 65 78 74 20 6f ┆ be sprinkled through the text o┆
0x0ce0…0d00 66 20 61 20 6e 6f 64 65 2e 20 20 54 68 69 73 20 69 73 20 75 73 75 61 6c 6c 79 20 74 68 65 20 62 ┆f a node. This is usually the b┆
0x0d00…0d20 65 73 74 20 77 61 79 20 74 6f 20 72 65 70 72 65 73 65 6e 74 20 6c 69 6e 6b 73 20 74 68 61 74 0a ┆est way to represent links that ┆
0x0d20…0d40 64 6f 20 6e 6f 74 20 66 69 74 20 74 68 65 20 74 72 65 65 20 73 74 72 75 63 74 75 72 65 2e 0a 0a ┆do not fit the tree structure. ┆
0x0d40…0d60 4d 6f 73 74 20 6f 66 74 65 6e 20 74 68 65 20 6e 6f 64 65 73 20 66 61 6c 6c 20 69 6e 74 6f 20 61 ┆Most often the nodes fall into a┆
0x0d60…0d80 20 73 74 72 69 63 74 20 74 72 65 65 20 73 74 72 75 63 74 75 72 65 2c 20 61 6e 64 20 6d 6f 73 74 ┆ strict tree structure, and most┆
0x0d80…0da0 20 6f 66 74 65 6e 20 74 68 69 73 0a 73 74 72 75 63 74 75 72 65 20 63 6f 72 72 65 73 70 6f 6e 64 ┆ often this structure correspond┆
0x0da0…0dc0 73 20 74 6f 20 74 68 65 20 73 74 72 75 63 74 75 72 65 20 6f 66 20 63 68 61 70 74 65 72 73 2c 20 ┆s to the structure of chapters, ┆
0x0dc0…0de0 73 65 63 74 69 6f 6e 73 2c 20 73 75 62 73 65 63 74 69 6f 6e 73 2c 0a 61 6e 64 20 73 6f 20 6f 6e ┆sections, subsections, and so on┆
0x0de0…0e00 20 6f 66 20 61 20 70 72 69 6e 74 65 64 20 6d 61 6e 75 61 6c 2e 20 20 42 75 74 20 74 68 65 72 65 ┆ of a printed manual. But there┆
0x0e00…0e20 20 61 72 65 20 74 69 6d 65 73 20 77 68 65 6e 20 74 68 69 73 20 69 73 20 6e 6f 74 20 72 69 67 68 ┆ are times when this is not righ┆
0x0e20…0e40 74 0a 66 6f 72 20 74 68 65 20 6d 61 74 65 72 69 61 6c 20 62 65 69 6e 67 20 64 69 73 63 75 73 73 ┆t for the material being discuss┆
0x0e40…0e60 65 64 2e 20 20 54 68 65 72 65 66 6f 72 65 2c 20 74 65 78 69 6e 66 6f 20 66 6f 72 6d 61 74 20 75 ┆ed. Therefore, texinfo format u┆
0x0e60…0e80 73 65 73 20 73 65 70 61 72 61 74 65 0a 63 6f 6d 6d 61 6e 64 73 20 74 6f 20 73 70 65 63 69 66 79 ┆ses separate commands to specify┆
0x0e80…0ea0 20 74 68 65 20 6e 6f 64 65 20 73 74 72 75 63 74 75 72 65 20 6f 66 20 74 68 65 20 49 6e 66 6f 20 ┆ the node structure of the Info ┆
0x0ea0…0ec0 66 69 6c 65 20 61 6e 64 20 74 68 65 20 73 65 63 74 69 6f 6e 0a 73 74 72 75 63 74 75 72 65 20 6f ┆file and the section structure o┆
0x0ec0…0ee0 66 20 74 68 65 20 61 20 70 72 69 6e 74 65 64 20 6d 61 6e 75 61 6c 2e 20 20 41 6c 73 6f 2c 20 74 ┆f the a printed manual. Also, t┆
0x0ee0…0f00 65 78 69 6e 66 6f 20 72 65 71 75 69 72 65 73 20 6d 65 6e 75 73 20 74 6f 20 62 65 0a 73 70 65 63 ┆exinfo requires menus to be spec┆
0x0f00…0f20 69 66 69 65 64 20 65 78 70 6c 69 63 69 74 6c 79 2c 20 72 61 74 68 65 72 20 74 68 61 6e 20 67 65 ┆ified explicitly, rather than ge┆
0x0f20…0f40 6e 65 72 61 74 69 6e 67 20 74 68 65 6d 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 62 61 73 65 ┆nerating them automatically base┆
0x0f40…0f60 64 20 6f 6e 20 61 6e 0a 61 73 73 75 6d 65 64 20 74 72 65 65 20 73 74 72 75 63 74 75 72 65 2e 0a ┆d on an assumed tree structure. ┆
0x0f60…0f80 0a 1f 0a 46 69 6c 65 3a 20 74 65 78 69 6e 66 6f 20 20 4e 6f 64 65 3a 20 63 6f 6d 6d 61 6e 64 73 ┆ File: texinfo Node: commands┆
0x0f80…0fa0 2c 20 50 72 65 76 3a 20 69 6e 66 6f 2c 20 55 70 3a 20 74 6f 70 2c 20 4e 65 78 74 3a 20 6d 61 6b ┆, Prev: info, Up: top, Next: mak┆
0x0fa0…0fc0 65 2d 69 6e 66 6f 0a 0a 47 65 6e 65 72 61 6c 20 53 79 6e 74 61 63 74 69 63 20 43 6f 6e 76 65 6e ┆e-info General Syntactic Conven┆
0x0fc0…0fe0 74 69 6f 6e 73 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ┆tions ==========================┆
0x0fe0…1000 3d 3d 3d 0a 0a 54 65 78 69 6e 66 6f 20 66 69 6c 65 73 20 63 6f 6e 74 61 69 6e 20 61 20 73 74 72 ┆=== Texinfo files contain a str┆
0x1000…1020 69 63 74 6c 79 20 6c 69 6d 69 74 65 64 20 73 65 74 20 6f 66 20 63 6f 6e 73 74 72 75 63 74 73 20 ┆ictly limited set of constructs ┆
0x1020…1040 66 6f 72 20 61 20 54 65 58 0a 6d 61 63 72 6f 20 70 61 63 6b 61 67 65 20 71 75 69 74 65 20 64 69 ┆for a TeX macro package quite di┆
0x1040…1060 66 66 65 72 65 6e 74 20 66 72 6f 6d 20 70 6c 61 69 6e 20 54 65 58 2e 20 20 54 68 65 20 73 74 72 ┆fferent from plain TeX. The str┆
0x1060…1080 69 63 74 20 6c 69 6d 69 74 73 20 6d 61 6b 65 20 69 74 0a 70 6f 73 73 69 62 6c 65 20 66 6f 72 20 ┆ict limits make it possible for ┆
0x1080…10a0 74 65 78 69 6e 66 6f 20 66 69 6c 65 73 20 74 6f 20 62 65 20 75 6e 64 65 72 73 74 6f 6f 64 20 61 ┆texinfo files to be understood a┆
0x10a0…10c0 6c 73 6f 20 62 79 20 74 68 65 20 60 74 65 78 69 6e 66 6f 27 0a 70 72 6f 67 72 61 6d 2c 20 77 68 ┆lso by the `texinfo' program, wh┆
0x10c0…10e0 69 63 68 20 63 6f 6e 76 65 72 74 73 20 74 68 65 6d 20 69 6e 74 6f 20 49 6e 66 6f 20 66 69 6c 65 ┆ich converts them into Info file┆
0x10e0…1100 73 2e 0a 0a 49 6e 20 6f 72 64 65 72 20 74 6f 20 62 65 20 6d 61 64 65 20 69 6e 74 6f 20 61 6e 20 ┆s. In order to be made into an ┆
0x1100…1120 49 6e 66 6f 20 66 69 6c 65 2c 20 61 20 74 65 78 69 6e 66 6f 20 66 69 6c 65 20 6d 75 73 74 20 73 ┆Info file, a texinfo file must s┆
0x1120…1140 74 61 72 74 20 77 69 74 68 20 61 0a 6c 69 6e 65 20 74 68 61 74 20 6c 6f 6f 6b 73 20 6c 69 6b 65 ┆tart with a line that looks like┆
0x1140…1160 0a 20 20 20 20 20 40 73 65 74 66 69 6c 65 6e 61 6d 65 20 49 4e 46 4f 2d 46 49 4c 45 2d 4e 41 4d ┆ @setfilename INFO-FILE-NAM┆
0x1160…1180 45 0a 77 68 69 63 68 20 73 70 65 63 69 66 69 65 73 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 ┆E which specifies the name of th┆
0x1180…11a0 65 20 49 6e 66 6f 20 66 69 6c 65 20 74 6f 20 62 65 20 67 65 6e 65 72 61 74 65 64 2e 20 20 49 6e ┆e Info file to be generated. In┆
0x11a0…11c0 20 66 61 63 74 2c 20 74 68 65 72 65 0a 63 61 6e 20 62 65 20 6f 74 68 65 72 20 74 68 69 6e 67 73 ┆ fact, there can be other things┆
0x11c0…11e0 20 69 6e 20 74 68 65 20 66 69 6c 65 20 62 65 66 6f 72 65 20 74 68 69 73 20 6c 69 6e 65 2c 20 62 ┆ in the file before this line, b┆
0x11e0…1200 75 74 20 74 68 65 79 20 61 72 65 20 69 67 6e 6f 72 65 64 20 69 6e 0a 74 68 65 20 67 65 6e 65 72 ┆ut they are ignored in the gener┆
0x1200…1220 61 74 69 6f 6e 20 6f 66 20 61 6e 20 49 6e 66 6f 20 66 69 6c 65 2e 20 20 54 68 65 20 60 40 73 65 ┆ation of an Info file. The `@se┆
0x1220…1240 74 66 69 6c 65 6e 61 6d 65 27 20 6c 69 6e 65 20 69 73 20 69 67 6e 6f 72 65 64 0a 77 68 65 6e 20 ┆tfilename' line is ignored when ┆
0x1240…1260 61 20 70 72 69 6e 74 65 64 20 6d 61 6e 75 61 6c 20 69 73 20 67 65 6e 65 72 61 74 65 64 2e 0a 0a ┆a printed manual is generated. ┆
0x1260…1280 41 6c 6c 20 41 53 43 49 49 20 70 72 69 6e 74 69 6e 67 20 63 68 61 72 61 63 74 65 72 73 20 65 78 ┆All ASCII printing characters ex┆
0x1280…12a0 63 65 70 74 20 60 40 27 2c 20 60 7b 27 20 61 6e 64 20 60 7d 27 20 63 61 6e 20 61 70 70 65 61 72 ┆cept `@', `{' and `}' can appear┆
0x12a0…12c0 20 69 6e 20 62 6f 64 79 0a 74 65 78 74 20 69 6e 20 61 20 74 65 78 69 6e 66 6f 20 66 69 6c 65 20 ┆ in body text in a texinfo file ┆
0x12c0…12e0 61 6e 64 20 73 74 61 6e 64 20 66 6f 72 20 74 68 65 6d 73 65 6c 76 65 73 2e 20 20 60 40 27 20 69 ┆and stand for themselves. `@' i┆
0x12e0…1300 73 20 74 68 65 20 65 73 63 61 70 65 0a 63 68 61 72 61 63 74 65 72 20 77 68 69 63 68 20 69 6e 74 ┆s the escape character which int┆
0x1300…1320 72 6f 64 75 63 65 73 20 63 6f 6d 6d 61 6e 64 73 2e 20 20 60 7b 27 20 61 6e 64 20 60 7d 27 20 73 ┆roduces commands. `{' and `}' s┆
0x1320…1340 68 6f 75 6c 64 20 62 65 20 75 73 65 64 20 6f 6e 6c 79 20 74 6f 0a 73 75 72 72 6f 75 6e 64 20 61 ┆hould be used only to surround a┆
0x1340…1360 72 67 75 6d 65 6e 74 73 20 74 6f 20 63 65 72 74 61 69 6e 20 63 6f 6d 6d 61 6e 64 73 2e 20 20 60 ┆rguments to certain commands. `┆
0x1360…1380 7b 27 20 61 6e 64 20 60 7d 27 20 61 70 70 65 61 72 69 6e 67 20 61 6e 79 77 68 65 72 65 0a 65 6c ┆{' and `}' appearing anywhere el┆
0x1380…13a0 73 65 20 77 69 6c 6c 20 62 65 20 74 72 65 61 74 65 64 20 62 79 20 54 65 58 20 61 73 20 61 20 67 ┆se will be treated by TeX as a g┆
0x13a0…13c0 72 6f 75 70 69 6e 67 20 62 75 74 20 74 72 65 61 74 65 64 20 62 79 20 74 65 78 69 6e 66 6f 20 61 ┆rouping but treated by texinfo a┆
0x13c0…13e0 73 0a 74 68 65 6d 73 65 6c 76 65 73 3b 20 74 68 69 73 20 69 6e 63 6f 6e 73 69 73 74 65 6e 63 79 ┆s themselves; this inconsistency┆
0x13e0…1400 20 69 73 20 75 6e 64 65 73 69 72 61 62 6c 65 2c 20 73 6f 20 64 6f 6e 27 74 20 6c 65 74 20 69 74 ┆ is undesirable, so don't let it┆
0x1400…1420 20 6f 63 63 75 72 2e 20 20 54 6f 0a 70 75 74 20 6f 6e 65 20 6f 66 20 74 68 65 73 65 20 73 70 65 ┆ occur. To put one of these spe┆
0x1420…1440 63 69 61 6c 20 63 68 61 72 61 63 74 65 72 73 20 69 6e 74 6f 20 74 68 65 20 64 6f 63 75 6d 65 6e ┆cial characters into the documen┆
0x1440…1460 74 2c 20 70 75 74 20 61 6e 20 60 40 27 20 63 68 61 72 61 63 74 65 72 0a 69 6e 20 66 72 6f 6e 74 ┆t, put an `@' character in front┆
0x1460…1480 20 6f 66 20 69 74 2e 0a 0a 49 74 20 69 73 20 63 75 73 74 6f 6d 61 72 79 20 69 6e 20 54 65 58 20 ┆ of it. It is customary in TeX ┆
0x1480…14a0 74 6f 20 75 73 65 20 64 6f 75 62 6c 65 64 20 73 69 6e 67 6c 65 2d 71 75 6f 74 65 20 63 68 61 72 ┆to use doubled single-quote char┆
0x14a0…14c0 61 63 74 65 72 73 20 74 6f 20 62 65 67 69 6e 0a 61 6e 64 20 65 6e 64 20 71 75 6f 74 61 74 69 6f ┆acters to begin and end quotatio┆
0x14c0…14e0 6e 73 2e 20 20 54 68 69 73 20 63 6f 6e 76 65 6e 74 69 6f 6e 20 73 68 6f 75 6c 64 20 62 65 20 66 ┆ns. This convention should be f┆
0x14e0…1500 6f 6c 6c 6f 77 65 64 20 69 6e 20 74 65 78 69 6e 66 6f 20 66 69 6c 65 73 2e 0a 0a 54 65 58 20 69 ┆ollowed in texinfo files. TeX i┆
0x1500…1520 67 6e 6f 72 65 73 20 74 68 65 20 6c 69 6e 65 2d 62 72 65 61 6b 73 20 69 6e 20 74 68 65 20 69 6e ┆gnores the line-breaks in the in┆
0x1520…1540 70 75 74 20 74 65 78 74 2c 20 65 78 63 65 70 74 20 66 6f 72 20 62 6c 61 6e 6b 20 6c 69 6e 65 73 ┆put text, except for blank lines┆
0x1540…1560 2c 0a 77 68 69 63 68 20 73 65 70 61 72 61 74 65 20 70 61 72 61 67 72 61 70 68 73 2e 20 20 54 65 ┆, which separate paragraphs. Te┆
0x1560…1580 78 69 6e 66 6f 20 67 65 6e 65 72 61 6c 6c 79 20 70 72 65 73 65 72 76 65 73 20 74 68 65 20 6c 69 ┆xinfo generally preserves the li┆
0x1580…15a0 6e 65 20 62 72 65 61 6b 73 0a 74 68 61 74 20 61 72 65 20 70 72 65 73 65 6e 74 20 69 6e 20 74 68 ┆ne breaks that are present in th┆
0x15a0…15c0 65 20 69 6e 70 75 74 20 66 69 6c 65 2e 20 20 54 68 65 72 65 66 6f 72 65 2c 20 79 6f 75 20 62 72 ┆e input file. Therefore, you br┆
0x15c0…15e0 65 61 6b 20 74 68 65 20 6c 69 6e 65 73 20 69 6e 20 74 68 65 0a 74 65 78 69 6e 66 6f 20 66 69 6c ┆eak the lines in the texinfo fil┆
0x15e0…1600 65 20 74 68 65 20 77 61 79 20 79 6f 75 20 77 61 6e 74 20 74 68 65 6d 20 74 6f 20 61 70 70 65 61 ┆e the way you want them to appea┆
0x1600…1620 72 20 69 6e 20 74 68 65 20 6f 75 74 70 75 74 20 49 6e 66 6f 20 66 69 6c 65 2c 20 61 6e 64 0a 6c ┆r in the output Info file, and l┆
0x1620…1640 65 74 20 54 65 58 20 74 61 6b 65 20 63 61 72 65 20 6f 66 20 69 74 73 65 6c 66 2e 0a 0a 0a 40 2d ┆et TeX take care of itself. @-┆
0x1640…1660 43 6f 6d 6d 61 6e 64 20 53 79 6e 74 61 78 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a ┆Command Syntax ================ ┆
0x1660…1680 0a 54 68 65 20 63 68 61 72 61 63 74 65 72 20 40 20 69 73 20 75 73 65 64 20 74 6f 20 73 74 61 72 ┆ The character @ is used to star┆
0x1680…16a0 74 20 73 70 65 63 69 61 6c 20 74 65 78 69 6e 66 6f 20 63 6f 6d 6d 61 6e 64 73 2e 20 20 28 49 74 ┆t special texinfo commands. (It┆
0x16a0…16c0 20 68 61 73 20 74 68 65 0a 73 61 6d 65 20 6d 65 61 6e 69 6e 67 20 74 68 61 74 20 5c 20 68 61 73 ┆ has the same meaning that \ has┆
0x16c0…16e0 20 69 6e 20 70 6c 61 69 6e 20 54 65 58 2e 29 20 20 53 79 6e 74 61 63 74 69 63 61 6c 6c 79 2c 20 ┆ in plain TeX.) Syntactically, ┆
0x16e0…1700 74 68 65 72 65 0a 61 72 65 20 74 68 72 65 65 20 63 6c 61 73 73 65 73 20 6f 66 20 40 2d 63 6f 6d ┆there are three classes of @-com┆
0x1700…1720 6d 61 6e 64 73 3a 0a 0a 20 20 31 2e 20 4e 6f 6e 2d 61 6c 70 68 61 62 65 74 69 63 20 63 6f 6d 6d ┆mands: 1. Non-alphabetic comm┆
0x1720…1740 61 6e 64 73 2c 20 40 20 66 6f 6c 6c 6f 77 65 64 20 62 79 20 61 20 70 75 6e 63 74 75 61 74 69 6f ┆ands, @ followed by a punctuatio┆
0x1740…1760 6e 20 63 68 61 72 61 63 74 65 72 2e 0a 20 20 20 20 20 54 68 65 73 65 20 63 6f 6d 6d 61 6e 64 73 ┆n character. These commands┆
0x1760…1780 20 61 72 65 20 61 6c 77 61 79 73 20 70 61 72 74 20 6f 66 20 74 68 65 20 74 65 78 74 20 77 69 74 ┆ are always part of the text wit┆
0x1780…17a0 68 69 6e 20 61 20 70 61 72 61 67 72 61 70 68 2c 20 61 6e 64 0a 20 20 20 20 20 6e 65 76 65 72 20 ┆hin a paragraph, and never ┆
0x17a0…17c0 74 61 6b 65 20 61 6e 79 20 61 72 67 75 6d 65 6e 74 2e 20 20 54 68 65 20 74 77 6f 20 63 68 61 72 ┆take any argument. The two char┆
0x17c0…17e0 61 63 74 65 72 73 20 28 40 20 61 6e 64 20 74 68 65 20 6f 74 68 65 72 20 6f 6e 65 29 0a 20 20 20 ┆acters (@ and the other one) ┆
0x17e0…1800 20 20 61 72 65 20 63 6f 6d 70 6c 65 74 65 20 69 6e 20 74 68 65 6d 73 65 6c 76 65 73 2e 0a 20 20 ┆ are complete in themselves. ┆
0x1800…1820 32 2e 20 41 6c 70 68 61 62 65 74 69 63 20 63 6f 6d 6d 61 6e 64 73 20 75 73 65 64 20 77 69 74 68 ┆2. Alphabetic commands used with┆
0x1820…1840 69 6e 20 61 20 70 61 72 61 67 72 61 70 68 2e 20 20 54 68 65 73 65 20 63 6f 6d 6d 61 6e 64 73 20 ┆in a paragraph. These commands ┆
0x1840…1860 68 61 76 65 20 40 0a 20 20 20 20 20 66 6f 6c 6c 6f 77 65 64 20 62 79 20 61 20 77 6f 72 64 2c 20 ┆have @ followed by a word, ┆
0x1860…1880 66 6f 6c 6c 6f 77 65 64 20 62 79 20 61 6e 20 61 72 67 75 6d 65 6e 74 20 77 69 74 68 69 6e 20 62 ┆followed by an argument within b┆
0x1880…18a0 72 61 63 65 73 2e 20 20 46 6f 72 0a 20 20 20 20 20 65 78 61 6d 70 6c 65 2c 20 74 68 65 20 63 6f ┆races. For example, the co┆
0x18a0…18c0 6d 6d 61 6e 64 20 60 40 69 27 20 73 70 65 63 69 66 69 65 73 20 69 74 61 6c 69 63 20 66 6f 6e 74 ┆mmand `@i' specifies italic font┆
0x18c0…18e0 20 28 66 6f 72 20 54 65 58 0a 20 20 20 20 20 70 72 6f 63 65 73 73 69 6e 67 20 6f 6e 6c 79 29 3b ┆ (for TeX processing only);┆
0x18e0…1900 20 69 74 20 69 73 20 75 73 65 64 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 20 60 49 20 64 6f 20 40 69 ┆ it is used as follows: `I do @i┆
0x1900…1920 7b 6e 6f 74 7d 20 77 61 6e 74 0a 20 20 20 20 20 74 6f 20 65 61 74 20 74 68 61 74 2e 27 0a 20 20 ┆{not} want to eat that.' ┆
[…truncated at 200 lines…]