Command Line Options
********************

GNU Info accepts several options to control the initial node being
viewed, and to specify which directories to search for Info files.  Here
is a template showing an invocation of GNU Info from the shell:

     info [--OPTION-NAME OPTION-VALUE] MENU-ITEM...

The following OPTION-NAMES are available when invoking Info from the
shell:

`--directory DIRECTORY-PATH'
`-d DIRECTORY-PATH'
     Add DIRECTORY-PATH to the list of directory paths searched when
     Info needs to find a file.  You may issue `--directory' multiple
     times; once for each directory which contains Info files.
     Alternatively, you may specify a value for the environment variable
     `INFOPATH'; if `--directory' is not given, the value of `INFOPATH'
     is used.  The value of `INFOPATH' is a colon separated list of
     directory names.  If you do not supply `INFOPATH' or
     `--directory-path', Info uses a default path.

`--file FILENAME'
`-f FILENAME'
     Specify a particular Info file to visit.  By default, Info visits
     the file `dir'; if you use this option, Info will start with
     `(FILENAME)Top' as the first file and node.

`--node NODENAME'
`-n NODENAME'
     Specify a particular node to visit in the initial file that Info
     loads.  This is especially useful in conjunction with `--file'(1).
     You may specify `--node' multiple times; for an interactive Info,
     each NODENAME is visited in its own window, for a non-interactive
     Info (such as when `--output' is given) each NODENAME is processed
     sequentially.

`--output FILENAME'
`-o FILENAME'
     Specify FILENAME as the name of a file to which to direct output.
     Each node that Info visits will be output to FILENAME instead of
     interactively viewed.  A value of `-' for FILENAME specifies the
     standard output.

`--subnodes'
     This option only has meaning when given in conjunction with
     `--output'.  It means to recursively output the nodes appearing in
     the menus of each node being output.  Menu items which resolve to
     external Info files are not output, and neither are menu items
     which are members of an index.  Each node is only output once.

`--help'
`-h'
     Produces a relatively brief description of the available Info
     options.

`--version'
     Prints the version information of Info and exits.

`MENU-ITEM'
     Info treats its remaining arguments as the names of menu items.
     The first argument is a menu item in the initial node visited,
     while the second argument is a menu item in the first argument's
     node.  You can easily move to the node of your choice by
     specifying the menu names which describe the path to that node.
     For example,

          info emacs buffers

     first selects the menu item `Emacs' in the node `(dir)Top', and
     then selects the menu item `Buffers' in the node `(emacs)Top'.

---------- Footnotes ----------

(1)  Of course, you can specify both the file and node in a `--node'
command; but don't forget to escape the open and close parentheses from
the shell as in: `info --node "(emacs)Buffers"'