Previous: help-q Up: ../info.html Next: menus
To add a new topic to the list in the directory, you must 1) create a node, in some file, to document that topic, and 2) put that topic in the directory. The new node can live in an existing documentation file, or in a new one. It must have a ^_ before it (invisible to the user; this node has one but you can't see it), and it ends with either a ^_, a ^L, or the end of file. Note: If you put in a ^L to end a new node, be sure that there is a ^_ after it to start the next one, since ^L can't START a node. Also, a nicer way to make a node boundary be a page boundary as well is to put a ^L RIGHT AFTER the ^_. The ^_ starting a node must be followed by a CRLF or a ^L CRLF, after which comes the node's header line. The header line must give the node's name (by which INFO will find it), and state the names of the Next, Previous, and Up nodes (if there are any). As you can see, this node's Up node is the node Top, which points at all the documentation for INFO. The Next node is "Menus". There is no Previous node. The keywords "Node", "Previous", "Up" and "Next", may appear in any order, anywhere in the header line, but the recommended order is the one in this sentence. Each keyword must be followed by a colon, spaces and tabs, and then the appropriate name. The name may be terminated with a Tab, a comma, or a CRLF. A space does not end it - node names may contain spaces. The case of letters in the names is insignificant. A node name has two forms. A node in the current file is named by what appears after the "Node: " in that node's first line. For example, this node's name is "ADD". A node in another file is named by "(filename)node-within-file", as in "(INFO)ADD" for this node. The default names for files are <INFO>.INFO. Parts of the filename which are the same as the default should be omitted for clarity; usually, just the first name of the file suffices. The name "(filename)Top" can be abbreviated to just "(filename)". By convention, the name "Top" is used for the "highest" node in any single file - the node whose "Up" points out of the file. The Directory node is "(DIR)". The Top node of a document file listed in the Directory should have an "Up: (DIR)" in it. The node name "*" is special - it refers to the entire file. Thus, G* will show you the whole current file. The use of the node * is to make it possible to make old-fashioned, unstructured files into nodes of the tree. <INFO>FOO.INFO can be made into a subnode by putting "(FOO)*" into a menu! The "Node:" name, in which a node states its own name, must not contain a filename, since INFO when searching for a node does not expect one to be there. The Next, Previous and Up names may contain them. In this node, since the Up node is in the same file, it was not necessary to use one. Note that the nodes in this file have a File name in the header line. The File names are ignored by INFO, but they help the user keep track of where he is (after all, just "Top" isn't much help).