Previous: help-q Up: ../info.html Next: menus

Add

 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).