[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
(no subject)
|
From: |
Adam Lazur |
|
Subject: |
(no subject) |
|
Date: |
Wed, 18 Oct 2000 10:58:07 -0500 |
|
User-agent: |
Mutt/1.2.5i |
# 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
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. lightblue, lightgreen). 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 it's 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 key by code value, use the supplied
program 'testkey' to obtain the needed value. It mainly is
a feature, when you wan't 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.
Here's an explanation of the key names:
KKEEYY__TTOOTTAALLSSEEAARRCCHH__11
Key for searching through all nodes of
info file.
KKEEYY__TTOOTTAALLSSEEAARRCCHH__22
Alternate key for searching through all
nodes of info file.
KKEEYY__SSEEAARRCCHH__11
Key for searching through current node
(or manual).
KKEEYY__SSEEAARRCCHH__22
Alternate key for searching through
current node (or manual).
KKEEYY__SSEEAARRCCHH__AAGGAAIINN__11
Key for repeating the last search.
KKEEYY__SSEEAARRCCHH__AAGGAAIINN__22
Alternate key for repeating the last
search.
KKEEYY__GGOOTTOO__11
Key for explicitly going to a node (by
specifing it's name).
KKEEYY__GGOOTTOO__22
Alternate key for explicitly going to a
node (by specifing it's name).
KKEEYY__PPRREEVVNNOODDEE__11
Key for going to a node marked as 'Prev'
in the header.
KKEEYY__PPRREEVVNNOODDEE__22
Alternate key for going to a node marked
as 'Prev' in the header.
KKEEYY__NNEEXXTTNNOODDEE__11
Key for going to a node marked as 'Next'
in the header.
KKEEYY__NNEEXXTTNNOODDEE__22
Alternate key for going to a node marked
as 'Next' in the header.
KKEEYY__UUPP__11 Key for scrolling text one line up.
KKEEYY__UUPP__22 Alternate key for scrolling text one
line
up.
KKEEYY__EENNDD__11 Key for going to the end of the node.
KKEEYY__EENNDD__22 Alternate key for going to the end of
the
node.
KKEEYY__PPGGDDNN__11
Key for going one page down in the viewed
node.
KKEEYY__PPGGDDNN__22
Alternate key for going one page down in
the viewed node.
KKEEYY__PPGGDDNN__AAUUTTOO__11
Key for going to the next node when
you're at the end of node (default is
zero -- turned off).
KKEEYY__PPGGDDNN__AAUUTTOO__22
Alternate key for going to the next node
when you're at the end of node (default
is space, as for pgdn_2).
KKEEYY__HHOOMMEE__11
Key for going to the beginning of the
node.
KKEEYY__HHOOMMEE__22
Alternate key for going to the beginning
of the node.
KKEEYY__PPGGUUPP__11
Key for going one page up in the viewed
node.
KKEEYY__PPGGUUPP__22
Alternate key for going one page up in
the viewed node.
KKEEYY__PPGGUUPP__AAUUTTOO__11
Key for going to the `up' node, when
being at the top of node. (Default value
is zero -- turned off).
KKEEYY__PPGGUUPP__AAUUTTOO__22
Alternate key for going to the `up' node,
when being at the top of node. (Default
value is `-', as for pgup_2).
KKEEYY__DDOOWWNN__11
Key for scrolling the text down one line.
KKEEYY__DDOOWWNN__22
Alternate key for scrolling the text down
one line.
KKEEYY__TTOOPP__11 Key for going to the top (first) node.
KKEEYY__TTOOPP__22 Alternate key for going to the
top
(first) node.
KKEEYY__BBAACCKK__11
Key for going back (in the history of
viewed nodes).
KKEEYY__BBAACCKK__22
Alternate key for going back (in the
history of viewed nodes).
KKEEYY__FFOOLLLLOOWWLLIINNKK__11
Key for following a hypertext link.
KKEEYY__FFOOLLLLOOWWLLIINNKK__22
Alternate key for following a hypertext
link.
KKEEYY__RREEFFRREESSHH__11
Key for refreshing the screen (hardcoded
is the ^L value).
KKEEYY__RREEFFRREESSHH__22
Alternate key for refreshing the screen.
KKEEYY__SSHHEELLLLFFEEEEDD__11
Key for calling a shell command, and
passing the viewed node to the stdin of
that command.
KKEEYY__SSHHEELLLLFFEEEEDD__22
Alternate key for calling a shell
command, and passing the viewed node to
the stdin of that command.
KKEEYY__QQUUIITT__11
Key for exiting the programm.
KKEEYY__QQUUIITT__22
Alternate key for exiting the programm.
KKEEYY__GGOOLLIINNEE__11
Key for going to a specified line in
file.
KKEEYY__GGOOLLIINNEE__22
Alternate key for going to a specified
line in file.
KKEEYY__PPRRIINNTT__11
Key for printing viewed node or man page.
KKEEYY__PPRRIINNTT__22
Alternate key for printing viewed node or
man page.
The special mnemonics for keys (which are defined at
present) are:
KKEEYY__BBRREEAAKK
KKEEYY__DDOOWWNN
KKEEYY__UUPP
KKEEYY__LLEEFFTT
KKEEYY__RRIIGGHHTT
KKEEYY__DDOOWWNN
KKEEYY__HHOOMMEE
KKEEYY__BBAACCKKSSPPAACCEE
KKEEYY__NNPPAAGGEE
KKEEYY__PPPPAAGGEE
KKEEYY__EENNDD [Note: this works probably OONNLLYY
with linux
ncurses]
KKEEYY__FF((xx))
KKEEYY__CCTTRRLL((''cc''))
- this assigns the key value to a _c_t_r_l_+_c
combination. _c may be any letter you
wish.
KKEEYY__AALLTT((''cc''))
- this assigns the key value to a _a_l_t_+_c
combination. _c may be any letter you
wish. If _a_l_t key won't work, you may use
_E_S_C_+_k_e_y combination.
''cc'' - this means a printable character _c. The
syntax is just like in C/C++ ;).
[[nnuummbbeerr]] - you can also specify key as it's
code
number. It is useful e.g. when specifing
control keys, and some nonstandard keys.
A numerical value of zero turns given
keybinding off.
See manual page for curs_getch (3x) for description of
their meaning.
Warning! Try not to create some serious keybinding
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
commandline arguments with the same names.
MMAANNUUAALL If this is set to ttrruuee the default
is to
first check for a man page, instead of a
texinfo file.
CCUUTT--MMAANN--HHEEAADDEERRSS
If set to true, then pinfo tries to cut
off the repeated headers throughout man
pages.
CCUUTT--EEMMPPTTYY--MMAANN--LLIINNEESS
If set to true, then pinfo tries to cut
off the repeated newlines (i.e. it will
shorten every repeating newlines to one
newline).
RRAAWW--FFIILLEENNAAMMEE
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 IINNFFOOPPAATTHH will only
be
searched if a file with this name is not
in the working directory.
AAPPRROOPPOOSS If set to true, aapprrooppooss is
called if no
info or man page is found.
DDOONNTT--HHAANNDDLLEE--WWIITTHHOOUUTT--TTAAGG--TTAABBLLEE
If set to ttrruuee , pinfo will not attempt
to display texinfo pages without tag
tables.
HHTTTTPPVVIIEEWWEERR
Set this to the program you want to use
to follow http links in documents.
FFTTPPVVIIEEWWEERR Set this to the program you want to
use
to follow ftp links in documents.
MMAAIILLEEDDIITTOORR
Set this to your favourite email program,
and it will be started if you follow an
email link in a document.
PPRRIINNTTUUTTIILLIITTYY
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. ;)
MMAANNLLIINNKKSS 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).
MMAANN--OOPPTTIIOONNSS
This specifies the options, which should
be passed to the `man' program. (see
man(1) for description of what they're
like).
SSTTDDEERRRR--RREEDDIIRREECCTTIIOONN
Pinfo allows you to redirect the stderr
output of called programms. For example
if you don't want to see man's error
messages about manual page formatting,
you can use
_S_T_D_E_R_-_R_E_D_I_R_E_C_T_I_O_N_=_"_2_>
_/_d_e_v_/_n_u_l_l_"_. _T_h_i_s _i_s
_t_h_e _d_e_f_a_u_l_t_.
LLOONNGG--MMAANNUUAALL--LLIINNKKSS
This is another true/false option, which
decides whether your system supports long
manual section names, or not. (i.e.
"3ncurses" instead of "3").
FFIILLTTEERR--00xxBB77
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).
QQUUIITT--CCOONNFFIIRRMMAATTIIOONN
This decides whether you want to use quit
confirmation on exit, or not.
QQUUIITT--CCOONNFFIIRRMM--DDEEFFAAUULLTT
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).
CCLLEEAARR--SSCCRREEEENN--AATT--EEXXIITT
This true/false option determines if you
want to have your screen cleared at exit,
or no.
HHIIGGHHLLIIGGHHTTRREEGGEEXXPP
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!
SSAAFFEE--UUSSEERR This option is used to pass the name
of
user, to which suid when pinfo is run
with root privileges.
SSAAFFEE--GGRROOUUPP
This option is used to pass the name of
group, to which suid when pinfo is run
with root privileges.
IINNTTEERRNNAATTIIOONNAALLIIZZAATTIIOONN
SSUUPPPPOORRTT
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'.
LLIICCEENNSSEE
This program is distributed under the terms of GPL.
BBUUGGSS
Please send bug reports to the author.
AAUUTTHHOORR
Przemek Borys <address@hidden@ddiioonnee..iiddss..ppll>
If that E-mail address wont work (since the machine where
it is being handled is a bit damaged lately), you can try
address@hidden@zzeeuuss..ppoollssll..gglliiwwiiccee..ppll,
or address@hidden@pp--
ssoofftt..ssiilleessiiaa..lliinnuuxx..oorrgg..ppll..
There was also a lot of other people, who contributed to
this code. See the AUTHORS file.
CCOOMMMMEENNTTSS
The author would like to read some comments and
suggestions from you, if any.
- (no subject),
Adam Lazur <=