← Back to branch summary

~ubuntu-branches/ubuntu/hardy/ratmenu/hardy

« back to all changes in this revision

Viewing changes to ratmenu.1

  • Committer: Bazaar Package Importer
  • Author(s): Jonathan Walther
  • Date: 2005-03-30 23:54:52 UTC
  • mfrom: (1.1.1 warty)
  • Revision ID: james.westby@ubuntu.com-20050330235452-ml5qm7wy12in9u39
Tags: 2.3.5
Fixed insufficiently initialized variable.

Show diffs side-by-side

added added

removed removed

Lines of Context:
ratmenu.1
12
12
] [
13
13
.BI \-bg " background-color"
14
14
] [
 
15
.BI \-io " item-offset"
 
16
] [
15
17
.BI \-label " name"
16
18
] [
17
19
.BI \-shell " prog"
20
22
] [
21
23
.BI \-style " {snazzy|dreary}"
22
24
] [
 
25
.BI \-persist
 
26
] [
23
27
.B \-version
24
28
] [
25
29
.IR menuitem\ command
51
55
instead of the default display.
52
56
.TP
53
57
.BI \-font " fname"
 
58
(X Resource: font)
54
59
Use the font
55
60
.IR fname ,
56
61
instead of the default font.
63
68
typically,
64
69
.BR ratmenu .
65
70
.TP
66
 
.BI \-fg " foreground-color"
 
71
.BI \-fg " foreground-color" 
 
72
(X Resource: fgcolor)
67
73
Set the foreground color to
68
74
.IR foreground-color .
69
75
By default, the foreground color is black.
70
76
.TP
71
 
.BI \-bg " background-color"
 
77
.BI \-bg " background-color" 
 
78
(X Resource: bgcolor)
72
79
Set the background color to
73
80
.IR background-color .
74
81
By default, the background color is white.
75
82
.TP
76
 
.BI \-style " {snazzy|dreary}"
 
83
.BI \-io " item-offset"
 
84
Set the first selected item to
 
85
.IR item-offset .
 
86
By default, the first item is the top-most one, or item-offset 1.  The next
 
87
item down would be at item-offset 2.
 
88
.TP
 
89
.BI \-style " {snazzy|dreary}" 
 
90
(X Resource: style)
77
91
The default style is
78
92
.IR snazzy ,
79
93
where the highlight bar, which shows the currently selected item, remains
83
97
mode, the highlight bar moves up and down the menu as it does on all conventional
84
98
keyboard controlled menus.
85
99
.TP
86
 
.BI \-align " {left|center|right}"
 
100
.BI \-align " {left|center|right}" 
 
101
(X Resource: align)
87
102
Align the text of the menu entries to the left, right, or center.
88
103
Defaults to
89
104
.IR left .
106
121
fall back to using
107
122
.BR /bin/sh .
108
123
.TP
 
124
.BI \-back " prevmenu"
 
125
.I prevmenu
 
126
is a command or shell script to run when the back key is pressed, usually a
 
127
script that has ratmenu showing the previous menu.  Used to create nested
 
128
menus, it gives the user a way to back out and return to the previous menu.
 
129
Note that you can use this option for other things too.  The command specified
 
130
by the
 
131
.B -back
 
132
option is executed when the user hits one of the "back" keys.
 
133
.TP
 
134
.BI \-persist 
 
135
(X Resource: persist)
 
136
Ordinarily, ratmenu exits if a new window pops up on top of it, or if you
 
137
switch to another window.  This option tells ratmenu to hang around, like a
 
138
regular window.
 
139
.TP
109
140
.B \-version
110
141
This option prints the version of
111
142
.I ratmenu
128
159
.RS
129
160
.TP
130
161
.BI Up
131
 
\'k\', Up_arrow, BackSpace, \'-\'
 
162
 'k', Up_arrow, BackSpace, '-'
132
163
.TP
133
164
.BI Down
134
 
\'j\', Down_arrow, Space, Tab, \'+\'
 
165
 'j', Down_arrow, Space, Tab, '+'
135
166
.TP
136
167
.BI Select
137
 
\'l\', Right_arrow, Return
 
168
 'l', Right_arrow, Return
 
169
.TP
 
170
.BI Back
 
171
 'h', Left_arrow
138
172
.TP
139
173
.BI Exit
140
 
\'q\', Escape
 
174
 'q', Escape
 
175
.RE
 
176
.SH CONFIGURATION USING X RESOURCES
 
177
.PP
 
178
You can configure some items using
 
179
.I xrdb
 
180
to load appropriate X resources.  There is an example configuration
 
181
in the file
 
182
.I /usr/share/doc/ratmenu/Xresources.ratmenu
 
183
which shows all possible configuration items.  Give it a look; it is
 
184
fairly easy to figure out.
141
185
.RE
142
186
.SH EXAMPLES
143
187
.ft B
145
189
ratmenu -label "Remotes xterm" acme "rsh acme xterm" herman "rsh herman 9term" &
146
190
.sp
147
191
ratmenu -label 'X progs' ghostview ghostview xdvi xdvi xeyes xeyes xneko xneko &
 
192
.sp
 
193
ratmenu -back ~/bin/mypreviousmenu "X Eyes" xeyes &
148
194
.ft
149
195
.fi
150
196
.SH SEE ALSO
151
197
.IR ratpoison (1),
152
 
.IR xvt (1),
153
 
.IR vim (1),
154
198
.IR ratpoisonrc (5),
155
199
.IR dialog (1)
 
200
.IR xrdb (1)
156
201
.PP
157
202
.IR "Ratpoison Desktop Users Manual" .
158
203
.SH AUTHORS
164
209
.B \-shell
165
210
option.
166
211
Jonathan Walther modified this code to play nicely with the ratpoison window
167
 
manager by removing handling of mouse events and iconification.
 
212
manager by removing handling of mouse events and iconification. Zrajm C Akfohg
 
213
made many improvements in his ratmen fork, including X resource handling, some
 
214
of which were folded back in.