(pinfo.info)Invoking

---

Next: Configuration Prev: Top Up: Top

---

Enter node , (file) or (file)node

1 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 argument
contains the name of an info page (i.e.  'bash').  The program will then
(by default) search for it in the current directory, '/usr/share/info',
'/usr/info', '/usr/local/share/info', '/usr/local/info', and
'/opt/info'.  Other searchpath may be specified in configfile or via
INFOPATH environmental variable.  Pinfo will also automatically 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 its 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 usual!  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 its 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 its 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 usually 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.  Since 0.6.7 it is also
     possible to specify nodes as in standalone info via filenames, like
     '(gcc)Introduction'.

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