|
|
thingmenu.1 - thingmenu - A simple graphical menu launcher for X11. |
|
|
 |
git clone git://bitreich.org/thingmenu (git://bitreich.org) |
|
|
 |
Log |
|
|
|
Files |
|
|
|
Refs |
|
|
|
Tags |
|
|
|
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 |
|