PINFO(1)

🦋 PINFO(1) 🦋

General Commands Manual ✨ so this whole thing lives in the General Commands Manual, section 1, and it's all about pinfo — bestie, you're gonna love her.

---

💖 NAME 💖

pinfo — she's a user-friendly, console-based viewer for Info documents. that's it, that's the whole vibe check. 🎀

---

✨ SYNTAX ✨

pinfo [options] [infopage]

---

🌸 DESCRIPTION 🌸

okay so. pinfo is a program for viewing info files. You tell it which page you wanna read by handing it an infopage argument. That argument holds the name of an info page (i.e. bash). Then the program will — by default — go hunting for it in the current directory, /usr/share/info, /usr/info, /usr/local/share/info, /usr/local/info, and /opt/info. 🔍 the search path can be adjusted by the INFOPATH environment variable, or in the configuration file. And pinfo will also automatically add the suffix -info, -info.Z, -info.gz, or -info.bz2. she's thorough like that 💅

When the search for info pages fails, man is called with the infopage argument, and its output gets parsed by pinfo. Which basically means: when you don't have the appropriate info page but you do have a man page instead, the man page will be viewed. no page left behind 🫶

When no infopage is specified, the default dir page is shown. iconic default behavior fr fr.

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 that follows this option is passed to the man program. Don't be confused if pinfo options that followed -m don't work. When using this option, pinfo does not parse the info options as usual! It invokes the man part of the program. it's giving "different mode entirely" 😭

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. sneaky but slay.

Previously there was a symlink to pinfo, called pman, but she had to be removed from the distribution, since her 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 — synonym for -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, the 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 auto cutting 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. the 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 the info file. Since 0.6.7 it is also possible to specify nodes as in standalone info via file names, like (gcc)Introduction.
• --rcfile=filename, --rcfile filename — Use an alternate configuration file.
• --long-manual-links, -l — 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.
• --clear-at-exit, -x — 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! 💀

---

🎀 DEFAULT KEYS WHEN BROWSING INFO FILE 🎀

Just take a look at the example configuration file (below), and at the key descriptions. Keys available in the manual viewer differ a bit from the keys available in the info viewer. lowkey important, bestie 👀

---

🌈 ENVIRONMENT 🌈

There is a variable $INFOPATH, which can specify the paths to be searched for info files. Its format is similar to that of the $PATH variable. An example setting could look like:

/usr/info:/usr/somewhere/info:/not/even/in/usr/info

etc. Directories are separated by colons. 🫶

---

💜 COLOR AND KEY DEFINITIONS 💜

There are configuration files called ~/.pinforc and [prefix]/etc/pinforc, for local and global configuration (where prefix is the prefix of the directory where pinfo is installed, i.e. /usr/local, or /). Here's an example of such a file; we'll discuss the contents below:

# Here are some color setting.
# Whitespace between the entries is optional.
COL_NORMAL = COLOR_WHITE, COLOR_BLACK, NO_BOLD, NO_BLINK
COL_MENUSELECTED = COLOR_RED, COLOR_BLACK, BOLD, NO_BLINK
COL_MENU=COLOR_BLUE,COLOR_BLACK,BOLD, NO_BLINK
COL_NOTESELECTED=COLOR_RED,COLOR_BLACK,BOLD, NO_BLINK
COL_NOTE=COLOR_GREEN,COLOR_BLACK,BOLD, NO_BLINK
COL_TOPLINE=COLOR_YELLOW,COLOR_BLUE,BOLD, NO_BLINK
COL_BOTTOMLINE=COLOR_YELLOW,COLOR_BLUE,BOLD, NO_BLINK
COL_MANUALBOLD=COLOR_WHITE,COLOR_BLACK,BOLD, NO_BLINK
COL_MANUALITALIC=COLOR_WHITE,COLOR_BLACK,BOLD, NO_BLINK
COL_URL=COLOR_MAGENTA,COLOR_BLACK,BOLD, NO_BLINK
COL_URLSELECTED=COLOR_RED,COLOR_BLACK,NO_BOLD, NO_BLINK
COL_INFOHIGHLIGHT=COLOR_WHITE,COLOR_BLACK,BOLD, NO_BLINK
#
# Here are some keybindings as well...
#
KEY_TOTALSEARCH_1 = 's'
KEY_TOTALSEARCH_2 = 'S'
KEY_SEARCH_1 = '/'
KEY_SEARCH_2 = '.'
KEY_GOTO_1='g'
KEY_GOTO_2='m'
KEY_HOME_1='h'
KEY_HOME_2='H'
KEY_PREVNODE_1='p'
KEY_PREVNODE_2='P'
KEY_NEXTNODE_1='n'
KEY_NEXTNODE_2='N'
KEY_UP_1=KEY_UP
KEY_UP_2='u'
KEY_END_1=
KEY_END_2='e'
KEY_PGDN_1=KEY_NPAGE
KEY_PGDN_2=' '
KEY_PGDN_AUTO_1=0
KEY_PGDN_AUTO_2=' '
KEY_PGUP_1=KEY_PPAGE
KEY_PGUP_2='b'
KEY_PGUP_AUTO_1=0
KEY_PGUP_AUTO_2='b'
KEY_DOWN_1=KEY_DOWN
KEY_DOWN_2='d'
KEY_TOP_1=KEY_HOME
KEY_TOP_2='t'
KEY_BACK_1=KEY_LEFT
KEY_BACK_2='l'
KEY_FOLLOWLINK_1=KEY_RIGHT
KEY_FOLLOWLINK_2='0
# 12 is a code for ctrl+l
KEY_REFRESH_1=12
KEY_REFRESH_2='~'
KEY_SHELLFEED_1='!'
KEY_SHELLFEED_2='1'
KEY_QUIT_1='q'
KEY_QUIT_2='Q'
KEY_DIRPAGE_1='d'
KEY_DIRPAGE_2='D'
KEY_GOLINE_1='l'
KEY_GOLINE_2=0
KEY_PRINT_1=']'
KEY_PRINT_2=0
#
# Some options, explained in the man page
#
MANUAL=false
CUT-MAN-HEADERS=true
CUT-EMPTY-MAN-LINES=true
RAW-FILENAME=false
APROPOS=false
DONT-HANDLE-WITHOUT-TAG-TABLE=false
LONG-MANUAL-LINKS=false
FILTER-0xB7=true
QUIT-CONFIRMATION=false
QUIT-CONFIRM-DEFAULT=no
CLEAR-SCREEN-AT-EXIT=true
STDERR-REDIRECTION="2> /dev/null"
HTTPVIEWER=lynx
FTPVIEWER=lynx
MAILEDITOR=pine
MANLINKS=1:8:2:3:4:5:6:7:9:n:p:o:3X11:3Xt
INFOPATH=/usr/info:/usr/share/info:/usr/local/info
HIGHLIGHTREGEXP=Bash.*has
SAFE-USER=nobody
SAFE-GROUP=nobody

As you can see, the format is simple. 💅 First I'll explain the color definitions. First you must enter a color name (all available color names are present in the example, and they're self explanatory, I think. There is also a special color COLOR_DEFAULT, which stands for transparency). Then you enter the foreground color, and the background color. The BOLD attribute means that we want the foreground color to be highlighted. (i.e. light blue, light green). The BLINK attribute is the blinking attribute, or highlighted background in some other configurations. ✨

Now let's move to the key definitions. Here we first put a key name (again all keys are present in the example); then we enter its value — either surrounded by apostrophes, or a keycode number (like in KEY_REFRESH_1), or its mnemonic code name if it's a special key (like i.e. in KEY_FOLLOWLINK_1). 🎀

If you wish to specify a key by code value, use the supplied program testkey to obtain the needed value. It mainly is a feature when you want to add some CTRL+letter keybindings, and similar. 👑

For each function you can bind two keys, i.e. you could bind both Enter and Cursor Right to the FollowLink-function. As you can see in the example above, the two key names are KEY_FOLLOWLINK_1 and KEY_FOLLOWLINK_2. two keys per function? we love options 💖

Here's an explanation of the key names:

• KEY_TOTALSEARCH_1 — Key for searching through all nodes of info file.
• KEY_TOTALSEARCH_2 — Alternate key for searching through all nodes of info file.
• KEY_SEARCH_1 — Key for searching through current node (or manual).
• KEY_SEARCH_2 — Alternate key for searching through current node (or manual).
• KEY_SEARCH_AGAIN_1 — Key for repeating the last search.
• KEY_SEARCH_AGAIN_2 — 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_PREVNODE_1 — Key for going to a node marked as Prev in the header. In man page viewer this goes to the previous man section.
• KEY_PREVNODE_2 — 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_NEXTNODE_1 — Key for going to a node marked as Next in the header. In man page viewer this goes to the next man section.
• KEY_NEXTNODE_2 — 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_PGDN_AUTO_1 — Key for going to the next node when you're at the end of node (default is zero — turned off).
• KEY_PGDN_AUTO_2 — Alternate key for going to the next node when you're 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 — the key that yeets you one whole page up in the node you're viewing. 💖
• KEY_PGUP_2 — alternate key for the exact same page-up glow-up. ✨
• KEY_PGUP_AUTO_1 — when you're already at the very top of a node, this key takes you to the `up' node. (default value is zero -- turned off). 🫶
• KEY_PGUP_AUTO_2 — alternate key for that same top-of-node-to-up' move.</purple> <yellow>(default value is -, as for pgup_2`). 💅
• KEY_DOWN_1 — scrolls the text down one line. 🌈
• KEY_DOWN_2 — alternate key for scrolling down one line. 🌈
• KEY_TOP_1 — goes to the top (first) node. 👑
• KEY_TOP_2 — alternate key for going to the top (first) node. 👑
• KEY_BACK_1 — goes back in the history of viewed nodes. 🦋
• KEY_BACK_2 — alternate key for going back in the history of viewed nodes. 🦋
• KEY_FOLLOWLINK_1 — follows a hypertext link. 🔗
• KEY_FOLLOWLINK_2 — alternate key for following a hypertext link. 🔗
• KEY_REFRESH_1 — refreshes the screen (hard coded is the ^L value). 🔄
• KEY_REFRESH_2 — alternate key for refreshing the screen. 🔄
• KEY_SHELLFEED_1 — calls a shell command, and passes the viewed node to the stdin of that command. 🐚
• KEY_SHELLFEED_2 — alternate key for calling a shell command, and passing the viewed node to the stdin of that command. 🐚
• KEY_QUIT_1 — exits the program. 💀
• KEY_QUIT_2 — alternate key for exiting the program. 💀
• KEY_GOLINE_1 — goes to a specified line in file. 📍
• KEY_GOLINE_2 — alternate key for going to a specified line in file. 📍
• KEY_PRINT_1 — prints the viewed node or man page. 🖨️
• KEY_PRINT_2 — alternate key for printing the viewed node or man page. 🖨️

okay bestie, the special mnemonics for keys that are defined at present are:

• KEY_BREAK
• KEY_DOWN
• KEY_UP
• KEY_LEFT
• KEY_RIGHT
• KEY_DOWN (yes, it's listed again — the page said it twice, so we keep it twice 💀)
• KEY_HOME
• KEY_BACKSPACE
• KEY_NPAGE
• KEY_PPAGE
• KEY_END [Note: this works probably ONLY with Linux ncurses]
• KEY_F(x)
• KEY_CTRL('c') — 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 won't 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.

for what all those mean, go peek at the manual page for curs_getch (3x). 📖

Warning! Try not to create some serious key binding conflicts! 🚨💥

the options in the last part of the example configuration file are pretty much self-explanatory, bestie. any variable you can set to true or false does the same thing as the command line argument with the same name. ✨

• 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 don't 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 they're like). 📘
• STDERR-REDIRECTION — pinfo allows you to redirect the stderr output of called programs. for example if you don't want to see man's 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 man's list marks a bit nicer ;) (look for example at perl's 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. 👥

🌍 INTERNATIONALIZATION SUPPORT 🌍

pinfo implements general features of the 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'.

📜 LICENSE 📜

This program is distributed under the terms of GPL.

🐛 BUGS 🐛

Please send bug reports to the author.

👑 AUTHOR 👑

Przemek Borys <pborys@dione.ids.pl> Bas Zoetekouw <bas@debian.org>

There was also a lot of other people, who contributed to this code. See the AUTHORS file.

💬 COMMENTS 💬

The author would like to read some comments and suggestions from you, if any.

---

and that's a wrap on the PINFO(1) page, bestie — dated 01 Dec 2001. go forth and browse info like the main character you are 💅✨👑