|Key for searching through all nodes of info file.|
|Alternate key for searching through all nodes of info file.|
|Key for searching through current node (or manual).|
|Alternate key for searching through current node (or manual).|
|Key for repeating the last search.|
|Alternate key for repeating the last search.|
|KEY_GOTO_1||Key for explicitly going to a node (by specifying its name).|
|KEY_GOTO_2||Alternate key for explicitly going to a node (by specifying its name).|
|Key for going to a node marked as Prev in the header. In man page viewer this goes to the previous man section.|
|Alternate key for going to a node marked as Prev in the header. In man page viewer this goes to the previous man section.|
|Key for going to a node marked as Next in the header. In man page viewer this goes to the next man section.|
|Alternate key for going to a node marked as Next in the header. In man page viewer this goes to the next man section.|
|KEY_UP_1||Key for scrolling text one line up.|
|KEY_UP_2||Alternate key for scrolling text one line up.|
|KEY_END_1||Key for going to the end of the node.|
|KEY_END_2||Alternate key for going to the end of the node.|
|KEY_PGDN_1||Key for going one page down in the viewed node.|
|KEY_PGDN_2||Alternate key for going one page down in the viewed node.|
|Key for going to the next node when youre at the end of node (default is zero -- turned off).|
|Alternate key for going to the next node when youre at the end of node (default is space, as for pgdn_2).|
|KEY_HOME_1||Key for going to the beginning of the node.|
|KEY_HOME_2||Alternate key for going to the beginning of the node.|
|KEY_PGUP_1||Key for going one page up in the viewed node.|
|KEY_PGUP_2||Alternate key for going one page up in the viewed node.|
|Key for going to the up node, when being at the top of node. (Default value is zero -- turned off).|
|Alternate key for going to the up node, when being at the top of node. (Default value is -, as for pgup_2).|
|KEY_DOWN_1||Key for scrolling the text down one line.|
|KEY_DOWN_2||Alternate key for scrolling the text down one line.|
|KEY_TOP_1||Key for going to the top (first) node.|
|KEY_TOP_2||Alternate key for going to the top (first) node.|
|KEY_BACK_1||Key for going back (in the history of viewed nodes).|
|KEY_BACK_2||Alternate key for going back (in the history of viewed nodes).|
|Key for following a hypertext link.|
|Alternate key for following a hypertext link.|
|Key for refreshing the screen (hard coded is the ^L value).|
|Alternate key for refreshing the screen.|
|Key for calling a shell command, and passing the viewed node to the stdin of that command.|
|Alternate key for calling a shell command, and passing the viewed node to the stdin of that command.|
|KEY_QUIT_1||Key for exiting the program.|
|KEY_QUIT_2||Alternate key for exiting the program.|
|Key for going to a specified line in file.|
|Alternate key for going to a specified line in file.|
|Key for printing viewed node or man page.|
Alternate key for printing viewed node or man page.
The special mnemonics for keys (which are defined at present) are:
See manual page for curs_getch (3x) for description of their meaning.
KEY_END [Note: this works probably ONLY with Linux ncurses]
- this assigns the key value to a ctrl+c combination. c may be any letter you wish. KEY_ALT(c) - this assigns the key value to a alt+c combination. c may be any letter you wish. If alt key wont work, you may use ESC+key combination. c - this means a printable character c. The syntax is just like in C/C++ ;). [number] - you can also specify key as its code number. It is useful e.g. when specifying control keys, and some nonstandard keys. A numerical value of zero turns given key binding off.
Warning! Try not to create some serious key binding conflicts!
The options in the last part of the example configuration file should be fairly self-explanatory. The variables that can be set to true or false do the same things as the command line arguments with the same names.
MANUAL If this is set to true the default is to first check for a man page, instead of a texinfo file. CUT-MAN-HEADERS If set to true, then pinfo tries to cut off the repeated headers throughout man pages. CUT-EMPTY-MAN-LINES If set to true, then pinfo tries to cut off the repeated newlines (i.e. it will shorten each set of consecutive newlines to one newline). RAW-FILENAME If set to true, the file argument is taken to be the name of a file in the current working directory, i.e. the directories in INFOPATH will only be searched if a file with this name is not in the working directory. APROPOS If set to true, apropos is called if no info or man page is found. DONT-HANDLE-WITHOUT-TAG-TABLE If set to true , pinfo will not attempt to display texinfo pages without tag tables. HTTPVIEWER Set this to the program you want to use to follow http links in documents. FTPVIEWER Set this to the program you want to use to follow ftp links in documents. MAILEDITOR Set this to your favorite email program, and it will be started if you follow an email link in a document. PRINTUTILITY Utility, which you use for printing. I.e. lpr. If you dont use any, you may also try something like cat >/dev/lp1, or sth. ;) MANLINKS This specifies the section names, which may be referenced in your man pages (i.e. Xtoolkit man pages match the section 3Xt (see for example XtVaCreateWidget) manpage), Xlib function pages match section 3X11, etc. Such extensions may not be recognized by default, so it is a good idea to add them). INFOPATH This allows you to override the default search path for info pages. The paths should be separated by colons. MAN-OPTIONS This specifies the options, which should be passed to the man program. (see man(1) for description of what theyre like). STDERR-REDIRECTION Pinfo allows you to redirect the stderr output of called programs. For example if you dont want to see mans error messages about manual page formatting, you can use STDER-REDIRECTION="2> /dev/null". This is the default. LONG-MANUAL-LINKS This is another true/false option, which decides whether your system supports long manual section names, or not. (i.e. "3ncurses" instead of "3"). FILTER-0xB7 This decides, whether you want to convert 0xb7 chars to o, or not. For example for iso-8859-2 fonts this makes mans list marks a bit nicer ;) (look for example at perls man page, to see how those marks look like). QUIT-CONFIRMATION This decides whether you want to use quit confirmation on exit, or not. QUIT-CONFIRM-DEFAULT This yes/no option determines the default answer to the QUIT-CONFIRMATION dialog. (default answer is when you press a key, that does not match the asked question). CLEAR-SCREEN-AT-EXIT This true/false option determines if you want to have your screen cleared at exit, or no. CALL-READLINE-HISTORY This true/false option determines if you want to have a prompt of last history entry whenever calling readline wrapper, eg. in subsequent searches. HIGHLIGHTREGEXP This is an option, through which you may pass to pinfo regexps, which should be highlighted when working with document. Warning! This may turn very slow if you use it without care! SAFE-USER This option is used to pass the name of user, to which suid when pinfo is run with root privileges. SAFE-GROUP This option is used to pass the name of group, to which suid when pinfo is run with root privileges.
Pinfo implements general features of gnu gettext library (the thing, which you need to see national messages ;). But it is not the end. Pinfo allows you to use national info pages! You only need to put them to your info directory, into a subdirectory, which is called $LANG.
This program is distributed under the terms of GPL.
Please send bug reports to the author.
Przemek Borys <email@example.com>
There was also a lot of other people, who contributed to this code. See the AUTHORS file.
The author would like to read some comments and suggestions from you, if any.
|-->||PINFO (1)||01 Dec 2001|