Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
FVWM-MENU-XLOCK(1)					      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 def-
     inition 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
	 Define menu icon for title. Default is no title icon (equivalent to  an
	 empty icon argument).

     --icon-item icon
	 Define menu icon for regular item. Default is no icon (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 argu-
     ment. 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-workers@fvwm.org or https://github.com/fvwmorg/fvwm3.

				   2026-06-27		      FVWM-MENU-XLOCK(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=fvwm-menu-xlock&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help