GNU Info

(pinfo.info)Invoking

---

Next: Configuration Prev: Top Up: Top

---

Enter node , (file) or (file)node

Invoking
********

   `pinfo' [OPTIONS] [INFO_PAGE]

   `pinfo' is a program for viewing info files. You specify which page
you want to read by passing it an INFO_PAGE argument. This argumen t
contains the name of an info page (i.e. `bash'). The program will then
(by default) search for it in `./', `/usr/info', `/usr/share/info' and
`/usr/local/info'. Other searchpath may be specified in configfile or
via INFOPATH environmental variable.  Pinfo will also automaticaly add
the suffix `-info', `-info.Z', `-info.gz', or `-info.bz2'. At present
other suffixes are not recognized, but you can easily add them to the
function `openinfo()' in `filehandling_functions.c'.

   When the search for info pages fails, man is called with the
INFO_PAGE argument, and it's output is parsed by `pinfo'. This means
that when you don't have the appropriate info page, but have a man page
instead; the man page will be viewed.

   When no INFO_PAGE is specified, the default `dir' page is shown.

Supported OPTIONS are

`-h, --help'
     print help information and exit

`-v, --version'
     print version information and exit

`-m, --manual'
     uses manual page instead of info by default. (`pinfo' `-m' could
     be used as a manual pager). Warning: Everything what follows this
     option is passed to the `man' program. Don't be confused if
     `pinfo' options, which followed `-m' don't work.  When using this
     option, pinfo does not parse the info options as ussual!  It
     invokes the man part of program.

     You can also call the man function of `pinfo' in another way.
     When `pinfo' is called with an `argv[0]' (the program file name),
     which contains the word `man' in it's name, the man functions are
     enabled automatically.

     Previously there was a symlink to `pinfo', called `pman', but I
     had to remove it from the distribution, since it's name was in
     conflict with some other utility. Anyway, you can feel free to
     create such a link if you wish.

`-r, --raw-filename'
     uses a raw filename first (i.e.  the name which you specified as
     infopage is considered to be a real file in the specified
     location).

`-f, --file'
     Same as '-r'.

`-a, --apropos'
     if this is set, apropos is called when no man or info page could be
     found.

`-c, --cut-man-headers'
     if this is set, man parsing code will try to cut out the repeated
     man headers. Use with care. ;)

`-s, --squeeze-lines'
     cut empty lines from manual pages. This option enables autocutting
     of every repeated newline in a manual page.

`-t, --force-manual-tag-table'
     forces manual detection of tag table. This allows you to view info
     pages, which may be corrupted.  (as i.e.  version of jed's pages,
     shipped with RH5.0). The tag table corruption ussualy appears in
     that the info links, which you follow, move you to quite
     unexpected nodes.

`--node=NODENAME, --node NODENAME'
     Go to the node NODENAME of info file.

`--rcfile=FILENAME, --node FILENAME'
     Use alternate rcfile.

`-l, --long-manual-links'
     Use long link names in manuals.  On some systems the manual
     hierarchy is divided into subsections like `3ncurses', etc, while
     on other systems all belongs to section `3'. If this option is
     what your system is like, feel free to use it.

`-x, --clear-at-exit'
     Clear screen at exit.

   The options are handled by GNU getopt, so you can here as in other
programs abbreviate the option names to the minimal number of characters
by which the options differ.

   Warning! If you do not have getopt, these options will not work!