thingmenu.1 - thingmenu - A simple graphical menu launcher for X11.
 (HTM) 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