fvwm-menu-xlock(1) Fvwm Utilities fvwm-menu-xlock(1)

NAME

fvwm-menu-xlock - builds xlock menu definition for fvwm

SYNOPSIS

fvwm-menu-xlock [ --help|-h|-? ] [ --version|-V ] [ --name|-n name ]
[ --title|-t title ] [ --item format ] [ --icon-title icon ] [
--icon-item icon ] [ --special-first|-s ] [ -- xlock params ]

DESCRIPTION

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

OPTIONS

--help
show the help and exit

--version
show the version and exit

--name name
define menu name in the following argument. Default is
"XLockMenu"

--title title
define menu title in the following argument. Default is "XLock
Modes".

--item format
define menu item format in the following argument, default is
'%n\t(%d)'. TAB can be specified as '\t', but in .fvwm2rc you
should specify a double backslash or a real TAB.

Format specifiers:

%n - mode name
%d - mode description
%D - mode description without "Shows " prefix if any

These specifiers can receive an optional integer size, positive
for right adjusted string or negative for left adjusted, example:
%8x; and optional *num or *-num, which means to leave only the
first or last (if minus) num of chars, the num must be greater
than 3, since the striped part is replaced with "...", example:
%*30x. Both can be combined: %-10*-20x, this instructs to get
only the 20 last characters, but if the length is less then 10 -
to fill with up to 10 spaces on the right.

--icon-title icon
--icon-item icon
define menu icon for title and regular item accordingly. Default
is no menu icons (equivalent to an empty icon argument).

--wm-icons
define icon names suitable for use with wm-icons package.
Currently this is equivalent to: --icon-title '' --icon-item
menu/lock.xpm.

--special-first
instructs to include special modes (usually black, bomb and
random) first.

Option parameters can be specified either using '=' or in the next
argument. Short options are ok if not ambiguous: -h, -t; but be
careful with short options, what is now unambiguous, can became
ambiguous in the next versions.

Additional arguments (after --) will be passed to xlock.

Please see the xlock(1) man page for the xlock options.

USAGE

Add these lines to your fvwm configuration file:

PipeRead 'fvwm-menu-xlock --name MenuSSaver --title "Screensaver" \
--icon-item mini-bball.xpm --special-first -- -nice 19 -nolock'
PipeRead 'fvwm-menu-xlock --name MenuSLock --title "Lock Screen" \
--icon-item mini-rball.xpm --special-first -- -nice 19'
AddToMenu "Utilities" "Screensaver%mini-monitor.xpm%" Popup MenuSSaver
AddToMenu "Utilities" "Screenlock%mini-lock.xpm%" Popup MenuSLock

AUTHORS

Charles K. Hines <chuck_hines@vnet.ibm.com>, initial version.

Mikhael Goikhman <migo@homemail.com>, from 24 Feb 1999.

COPYING

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

BUGS

Depends on the output of xlock. Will produce an empty menu if the
structure of the output is changed.

Report bugs to fvwm-bug@fvwm.org.

2.5.28 (from cvs) 2009-03-22 fvwm-menu-xlock(1)