thingmenu.1 - thingmenu - A simple graphical menu launcher for X11.
HTML git clone git://bitreich.org/thingmenu
DIR Log
DIR Files
DIR Refs
DIR Tags
DIR LICENSE
---
thingmenu.1 (2347B)
---
1 .Dd July 02, 2011
2 .Dt THINGMENU 1
3 .Os
4 .
5 .Sh NAME
6 .Nm thingmenu
7 .Nd a simple menu for X11
8 .
9 .Sh SYNOPSIS
10 .Nm
11 .Bk -words
12 .Op Fl n
13 .Op Fl o
14 .Op Fl s
15 .Op Fl x
16 .Op Fl g Ar geometry
17 .Op Fl w Ar widthscaling
18 .Op Fl e Ar heightscaling
19 .Op Fl -
20 .Ar label0 cmd0 [label1 cmd1 ...]
21 .Ek
22 .
23 .Sh DESCRIPTION
24 .Bd -filled
25 .Nm
26 is a simple menu for X11. The menu can be displayed in a horizontal or
27 a vertical layout. The manual specification of the parameters of the
28 menu makes it flexible to be used in many circumstances.
29 .Ed
30 .
31 .Sh IMPLEMENTATION
32 .Bd -filled
33 Installation is as straighforward as grabbing the tar.gz file, extracting
34 it and running
35 .Qq "make; make install;"
36 inside the
37 .Qq "thingmenu-*"
38 directory.
39 The prefix for the installation can easily set using
40 .Qq "PREFIX=/usr make install".
41 .Ed
42 .
43 .Sh OPTIONS
44 .Nm
45 options and default settings.
46 .Pp
47 .Bl -tag -width ".Fl test Ao Ar string Ac"
48 .
49 .It Fl x
50 Do not append a
51 .Qq "Cancel"
52 menu item.
53 .Bd -filled
54 .It Fl s
55 Disable the oneshot behaviour. After one button click
56 .Nm
57 won't exit,
58 except when the
59 .Qq "Cancel"
60 button is clicked.
61 .Ed
62 .
63 .It Fl o
64 Use the horizontal layout.
65 .
66 .It Fl n
67 Prepend the numpad keys for shortcuts to the entries.
68 .
69 .It Fl g
70 Define the X11 geometry string, which is to be used.
71 .
72 .It Fl w
73 Define the width scaling.
74 .
75 .It Fl e
76 Define the height scaling.
77 .
78 .El
79 .
80 .Sh CUSTOMIZATION
81 .Bd -filled
82 .Nm
83 is customized by creating a custom config.h and (re)compiling the
84 source code.
85 .Ed
86 .
87 .Sh EXAMPLES
88 .Bd -filled
89 Open a three times scaled wide menu, which is showing an entry
90 .Qq "Reboot now".
91 When being clicked this entry will run
92 .Qq "reboot".
93 After that the menu will not exit (-s).
94 .Ed
95 .Bd -literal
96 % thingmenu -s -w 3 -- "Reboot now" reboot
97 .Ed
98 .Bd -filled
99 This will create a centered menu, which is aligned based on the length of the
100 label texts. After the first clicked entry it will exit.
101 .Ed
102 .Bd -literal
103 % thingmenu "Force reboot" "reboot -f" Shutdown shutdown
104 .Ed
105 .Bd -filled
106 An example how to create multi-level menus is shown in the thingmenu-menu.sh
107 file, included in the distribution.
108 .Ed
109 .
110 .Sh FILES
111 LICENSE, thingmenu-menu.sh, config.def.h, config.h
112 .
113 .Sh AUTHORS
114 See LICENSE file for authors in the distribution.
115 .
116 .Sh LICENSE
117 .Nm
118 is released under the MIT/X Consortium License.
119 .
120 .Sh BUGS
121 .Ss "Reporting Bugs"
122 Report bugs to:
123 .An "Christoph Lohmann" Aq 20h@R-36.net
124