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.

--index-search string

Go to the index entry string in the Info file specified with `--file'. If no such entry, print `no entries found' and exit with nonzero status. This can used from another program as a way to provide online help.

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

Go to the first, previous, next, last section, table of contents.