1fvwm-menu-xlock(1)              Fvwm Utilities              fvwm-menu-xlock(1)
2
3
4

NAME

6       fvwm-menu-xlock - builds xlock menu definition for fvwm
7

SYNOPSIS

9       fvwm-menu-xlock [ --help⎪-h⎪-? ] [ --version⎪-V ] [ --name⎪-n name ] [
10       --title⎪-t title ] [ --item format ] [ --icon-title icon ] [
11       --icon-item icon ] [ --special-first⎪-s ] [ -- xlock params ]
12

DESCRIPTION

14       A simple perl script which parses xlock's output to build an fvwm menu
15       definition of all xlock's modes.
16

OPTIONS

18       --help
19           show the help and exit
20
21       --version
22           show the version and exit
23
24       --name name
25           define menu name in the following argument.  Default is "XLockMenu"
26
27       --title title
28           define menu title in the following argument.  Default is "XLock
29           Modes".
30
31       --item format
32           define menu item format in the following argument, default is
33           '%n\t(%d)'.  TAB can be specified as '\t', but in .fvwm2rc you
34           should specify a double backslash or a real TAB.
35
36           Format specifiers:
37
38             %n - mode name
39             %d - mode description
40             %D - mode description without "Shows " prefix if any
41
42           These specifiers can receive an optional integer size, positive for
43           right adjusted string or negative for left adjusted, example: %8x;
44           and optional *num or *-num, which means to leave only the first or
45           last (if minus) num of chars, the num must be greater than 3, since
46           the striped part is replaced with "...", example: %*30x. Both can
47           be combined: %-10*-20x, this instructs to get only the 20 last
48           characters, but if the length is less then 10 - to fill with up to
49           10 spaces on the right.
50
51       --icon-title icon
52       --icon-item icon
53           define menu icon for title and regular item accordingly.  Default
54           is no menu icons (equivalent to an empty icon argument).
55
56       --wm-icons
57           define icon names suitable for use with wm-icons package.  Cur‐
58           rently this is equivalent to: --icon-title '' --icon-item
59           menu/lock.xpm.
60
61       --special-first
62           instructs to include special modes (usually black, bomb and random)
63           first.
64
65       Option parameters can be specified either using '=' or in the next
66       argument.  Short options are ok if not ambiguous: -h, -t; but be care‐
67       ful with short options, what is now unambiguous, can became ambiguous
68       in the next versions.
69
70       Additional arguments (after --) will be passed to xlock.
71
72       Please see the xlock(1) man page for the xlock options.
73

USAGE

75       Add these lines to your fvwm configuration file:
76
77         PipeRead 'fvwm-menu-xlock --name MenuSSaver --title "Screensaver" \
78           --icon-item mini-bball.xpm --special-first -- -nice 19 -nolock'
79         PipeRead 'fvwm-menu-xlock --name MenuSLock --title "Lock Screen" \
80           --icon-item mini-rball.xpm --special-first -- -nice 19'
81         AddToMenu "Utilities" "Screensaver%mini-monitor.xpm%" Popup MenuSSaver
82         AddToMenu "Utilities" "Screenlock%mini-lock.xpm%"     Popup MenuSLock
83

AUTHORS

85       Charles K. Hines <chuck_hines@vnet.ibm.com>, initial version.
86
87       Mikhael Goikhman <migo@homemail.com>, from 24 Feb 1999.
88

COPYING

90       The script is distributed by the same terms as fvwm itself.  See GNU
91       General Public License for details.
92

BUGS

94       Depends on the output of xlock. Will produce an empty menu if the
95       structure of the output is changed.
96
97       Report bugs to fvwm-bug@fvwm.org.
98
99
100
101perl v5.8.0                       2003-03-15                fvwm-menu-xlock(1)
Impressum