pinfo: Invoking
1
1 1 Invoking
1 **********
1
1 'pinfo' [OPTIONS] [INFO_PAGE]
1
1 'pinfo' is a program for viewing info files. You specify which page
1 you want to read by passing it an INFO_PAGE argument. This argumen t
1 contains the name of an info page (i.e. 'bash'). The program will then
1 (by default) search for it in the current diectory, '/usr/share/info',
1 '/usr/info', '/usr/local/share/info', '/usr/local/info', and
1 '/opt/info'. Other searchpath may be specified in configfile or via
1 INFOPATH environmental variable. Pinfo will also automaticaly add the
1 suffix '-info', '-info.Z', '-info.gz', or '-info.bz2'. At present other
1 suffixes are not recognized, but you can easily add them to the function
1 'openinfo()' in 'filehandling_functions.c'.
1
1 When the search for info pages fails, man is called with the
1 INFO_PAGE argument, and it's output is parsed by 'pinfo'. This means
1 that when you don't have the appropriate info page, but have a man page
1 instead; the man page will be viewed.
1
1 When no INFO_PAGE is specified, the default 'dir' page is shown.
1
1 Supported OPTIONS are
1
1 '-h, --help'
1 print help information and exit
1 '-v, --version'
1 print version information and exit
1 '-m, --manual'
1 uses manual page instead of info by default. ('pinfo' '-m' could
1 be used as a manual pager). Warning: Everything what follows this
1 option is passed to the 'man' program. Don't be confused if
1 'pinfo' options, which followed '-m' don't work. When using this
1 option, pinfo does not parse the info options as ussual! It
1 invokes the man part of program.
1
1 You can also call the man function of 'pinfo' in another way. When
1 'pinfo' is called with an 'argv[0]' (the program file name), which
1 contains the word 'man' in it's name, the man functions are enabled
1 automatically.
1
1 Previously there was a symlink to 'pinfo', called 'pman', but I had
1 to remove it from the distribution, since it's name was in conflict
1 with some other utility. Anyway, you can feel free to create such
1 a link if you wish.
1 '-r, --raw-filename'
1 uses a raw filename first (i.e. the name which you specified as
1 infopage is considered to be a real file in the specified
1 location).
1 '-f, --file'
1 Same as '-r'.
1 '-a, --apropos'
1 if this is set, apropos is called when no man or info page could be
1 found.
1 '-c, --cut-man-headers'
1 if this is set, man parsing code will try to cut out the repeated
1 man headers. Use with care. ;)
1 '-s, --squeeze-lines'
1 cut empty lines from manual pages. This option enables autocutting
1 of every repeated newline in a manual page.
1 '-t, --force-manual-tag-table'
1 forces manual detection of tag table. This allows you to view info
1 pages, which may be corrupted. (as i.e. version of jed's pages,
1 shipped with RH5.0). The tag table corruption ussualy appears in
1 that the info links, which you follow, move you to quite unexpected
1 nodes.
1 '--node=NODENAME, --node NODENAME'
1 Go to the node NODENAME of info file. Since 0.6.7 it is also
1 possible to specify nodes as in standalone info via filenames, like
1 '(gcc)Introduction'.
1
1 '--rcfile=FILENAME, --node FILENAME'
1 Use alternate rcfile.
1 '-l, --long-manual-links'
1 Use long link names in manuals. On some systems the manual
1 hierarchy is divided into subsections like '3ncurses', etc, while
1 on other systems all belongs to section '3'. If this option is
1 what your system is like, feel free to use it.
1 '-x, --clear-at-exit'
1 Clear screen at exit.
1
1 The options are handled by GNU getopt, so you can here as in other
1 programs abbreviate the option names to the minimal number of characters
1 by which the options differ.
1
1 Warning! If you do not have getopt, these options will not work!
1