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

FreeBSD Manual Pages

  
 
  

home | help
XMTOOLBOX(1)		    General Commands Manual		  XMTOOLBOX(1)

NAME
       xmtoolbox - application launcher

SYNOPSIS
       xmtoolbox [-rcfile <file>] [-horizontal]	[-hotkey [modifier[+...]]+key]

DESCRIPTION
       XmToolbox  displays  a  user  defined,  multi-level menu	of application
       groups and applications.	It also	interfaces with	 the  xmsm(1)  session
       manager to provide screen locking and session commands.

OPTIONS
       -rcfile <full path>
	      Specify  a  configuration	file to	use. See CONFIGURATION for de-
	      tails.

       -title String
	      Specify toolbox window title. Default is user's login  name  and
	      the host name.

       -hotkey [Modifier ...] Key
	      Hotkey  to raise and focus the toolbox window.  See the resource
	      description below.

       -horizontal
	      Specifies	whether	the top-level menu should be laid out horizon-
	      tally, rather than vertically.

CONFIGURATION
       XmToolbox reads its menu	configuration from text	files. If  not	speci-
       fied  on	command	line with the -rcfile option, its location defaults to
       .toolboxrc in user's home directory and toolboxrc in any	of system con-
       figuration directories e.g. /etc/X11, /usr/lib/X11.

       A menu is defined by specifying the menu	title followed by one or  more
       menu item definitions enclosed in {...} brackets. Menu items are	speci-
       fied  one  per  line, starting with the title string separated by the :
       character from the command<*> to	be executed. A horizontal line may  be
       added  between  menu  items  with the special identifier	SEPARATOR. Any
       character in the	title string may be prefixed with the ampersand	 char-
       acter  to  specify  a mnemonic. Comments	may be entered following the #
       character at the	beginning of a line. Sub-menus may be defined by plac-
       ing them	within the scope of the	parent menu. Menu scope	{}  delimiters
       may only	be placed at the beginning of an otherwise empty line.

       Literal & and : characters in title strings may be specified by prefix-
       ing  them with the \ escape character. Literal whitespace characters in
       the command string may be specified either by escaping them with	\,  or
       enclosing the part of the string	in quotation marks.

       The command string may contain sh(1) like ($... and ${...}) environment
       variables, which	will be	expanded accordingly. A	literal	$ may be spec-
       ified with $$. Undefined	variables are not treated as error, and	expand
       to nothing, though a warning is printed to stderr.

       # Comment

       Menu Title
       {
	    Title: Command
	    SEPARATOR
	    ...

	    Submenu Title
	    {
		 Title:	Command
		 ...
	    }
       }

RESOURCES
       title String
	      This  resource  is  used	to specify a custom window title.  De-
	      faults to	user's login name and the host name: <user>@<host>.

       dateTimeDisplay Boolean
	      Display date and time. Default is	True.

       dateTimeFormat String
	      Date and time format string. See strftime(3).  Defaults  to  "%D
	      %l:%M %p".

       hotkey [Modifier	...] Key | None
	      One  or  more  modifiers followed	by a key name (X KeySym	names,
	      separated	by whitespace or +) defining the hotkey	to  raise  and
	      focus  the  toolbox window at any	time, or None if no hotkey as-
	      signment is desired. Defaults to None.

       horizontal Boolean
	      Specifies	whether	the top-level menu should be laid out horizon-
	      tally, rather than vertically. Default is	False.

       rcFile String
	      Full path	to the configuration file. See CONFIGURATION  for  de-
	      tails.

       separators Boolean
	      If  true,	separators will	be displayed between launcher, session
	      and time/date display parts. Default is True.

SIGNALS
       XmToolbox responds to SIGUSR1 signal by reparsing the  menu  configura-
       tion file.

SEE ALSO
       xmsm(1) emwm(1)

AUTHORS
       Toolbox was written and is maintained by	alx@fastestcode.org

								  XMTOOLBOX(1)

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

home | help