1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
|
.\" -*- nroff -*-
.TH PDMENU 1 "February 13 2000" "1.2.59" "Commands"
.SH NAME
pdmenu \- simple full screen menu program
.SH SYNOPSIS
.B pdmenu [\fIoptions\fP] [\fImenufile\fP ...]
.SH DESCRIPTION
.I pdmenu
is a simple menu program that displays a menu from which the
user can pick programs to run. Submenus are supported.
.PP
When you run
.I pdmenu
, you will be presented with a menu. Simply use the arrow
keys to move to the program you want to run, and press Enter to run the
program. When the program ends, you will be returned to the menu.
.PP
If you are running
.I pdmenu
at the linux console, and gpm is running, you can
move the mouse and click to navigate through the menus.
.PP
Some menu items are actually submenus, and will take you to another menu.
Others may cause a text edit window to be displayed, where you can enter
parameters for a command before running it. Still others may run a command,
and display the output in a window.
.SH KEYS
Here are all keys you need to get around in \fIpdmenu\fP:
.IP "[up arrow], 8, -"
Move up one line in the menu.
.IP "[down arrow], 2, +"
Move down one line.
.IP "[page up], [ctrl-u]"
Move up an entire screen.
.IP "[page down], [space], [ctrl-v]"
Move down an entire screen.
.IP "[home]"
Move to the first entry of the menu.
.IP "[end]"
Move to the last entry of the menu.
.IP "q"
Exit the current menu, or exit
.I pdmenu
if used on the first menu. Does not
work in the text edit windows. (This will not work if there is also a hotkey
set up for \*(L'q\*(R', the hotkey takes precedence.)
.IP "ESC"
Close the currently active window, and return to the previous window, or
exit
.I pdmenu
if used on the first menu.
.IP "[ctrl-c]"
Exit
.I pdmenu
immediately.
.IP "[ctrl-r]"
Force a redraw of the screen.
.IP "[enter]"
Launch the selected menu item. In a text edit window, closes the window.
.IP "[backspace]"
Performs a destructive backspace in a text edit window.
.IP "hotkeys"
Some letters of a menu item may be highlighted. These are hotkeys; simply
press the highlighted letter to select the next menu item with that hotkey.
.SH OPTIONS
.IP "-h, --help"
Display usage summary and exit.
.IP "-c, --color"
Use color. By default,
.I pdmenu
will display in black and white mode. If your
terminal supports color, use this switch.
.IP "-u, --unpark"
"Unparks" the cursor from the bottom of the screen. When this option is
selected, the cursor moves to be on the line of the menu that is currently
selected. This makes
.I pdmenu
more useable with speech synthesis systems that
need to know what line is the current line on the screen.
.IP "-mmenuid, --menu=menuid"
Instead of displaying the first menu from the menufile, select the menu
with the id "menuid" and display it.
.IP "-q, --quit"
By default, at the opening menu, 'q' will exit \fIpdmenu\fP.
If the \-q switch is
specified, this will not be the case. This is useful if you want to prevent
the user from ever exiting \fIpdmenu\fP.
.SP
This also disables control-c and the right mouse button from exiting
\fIpdmenu\fP.
.IP "-r, --retro"
This makes
.I pdmenu
use an old style for displaying menus. Menus in the background don't change
color, or lose their hotkeys. Note that this will also be a little bit
faster than the default on slow terminals and the like.
.IP "-l, --lowbit"
By default,
.I pdmenu
will use nice high bit line drawing characters if it
thinks your terminal is capable. Sometimes it gets this wrong and you get
borders that look all messed up. Then you should use this --lowbit switch to
force it to use low bit line draing characters.
.IP "-n, --numeric"
Disables the use of the keys 2 and 8 for moving up and down. This is useful
if you want to use numbered hotkeys.
.IP "menufile ..."
Specify a menu definition file or files to use. If you specify multiple
files, they will all be loaded in together. By default, the first menu in
the first menufile will be displayed when
.I pdmenu
starts, but this can be overridden by the --menu= option.
If menufile is "-", pdmenu will read standard input as a menu file.
.SH NOTES
To use the mouse to cut and paste as usual, hold down on the shift key when
you use the mouse.
.SH FILES
.I /usr/local/etc/pdmenurc
.RS
Default config file. See
.BR pdmenurc (5)
for details.
.RE
.I ~/.pdmenurc
.RS
If this exists, it overrides /usr/local/etc/pdmenurc. See
.BR pdmenurc (5)
for details.
.SH ENVIRONMENT
.IP COLORTERM
Set this variable to make
.I pdmenu
to use color by default.
.SH DISTRIBUTION
Redistribution is subject to the GNU public license.
.SH BUGS
See the file BUGS that came with
.I pdmenu
for the current buglist.
.SH AUTHOR
Joey Hess, <joey@kitenet.net>.
.SH "SEE ALSO"
.BR pdmenurc (5)
|
