thingmenu

A simple graphical menu launcher for X11.
git clone git://r-36.net/thingmenu
Log | Files | Refs | LICENSE

thingmenu.1 (2273B)


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