ROOTMENU(5)

NAME
rootmenu - root menu specification for SunView

SYNOPSIS
~/.rootmenu
/usr/lib/.rootmenu

DESCRIPTION

If a .rootmenu file is present in a user's home directory, it specifies the SunView menu, the menu that appears when the user clicks and holds the right mouse button in the background of the SunView desktop. If a .rootmenu file is not present in the user's home directory, /usr/lib/.rootmenu specifies the SunView menu.

Each line of a .rootmenu file has the format:

    menu item
        command

menu item can be a character string, or an icon file delimited by angle brackets:

    <icon-filename>

If menu item is a character string with embedded spaces, it must be enclosed by double quotes (`"').

command can be a command line to be executed when the menu item is selected, or one of the following reserved-word commands:

    EXIT
        Exit sunview (requires confirmation).

    REFRESH
        Redraw the entire screen.

    MENU
        This menu item is a pull-right item with a submenu. If a full pathname follows the MENU command, the submenu contents are taken from that file. Otherwise, all the lines between a MENU command and a matching END command are added to the submenu.

    END Mark the end of a nested submenu. The left side of this line should match the left side of a line with a MENU command.

If command is not one of the reserved-word commands, it is treated as a command line, although no shell interpretation is done.

Lines beginning with a `#' character are considered comments and are ignored.

If a user's .rootmenu file is modified, the SunView menu immediately reflects the changes.

See sunview(1) for more details about .rootmenu.

EXAMPLES

The following is a sample .rootmenu file:

#
#	sample root menu
#
"Lock Screen"		lockscreen
Tools     MENU
	Perfmeter		perfmeter
	Calculator		calc
	Mailtool		mailtool
Tools     END
"ShellTool"		shelltool
"CommandTool"	cmdtool
"Console"		cmdtool -C
#"MailTool"		mailtool
"TextEditor"		textedit
"DefaultsEditor"	defaultsedit
#"IconEditor"		iconedit
#"DbxTool"		dbxtool
"PerfMeter"		perfmeter
#"GraphicsTool"	gfxtool
"Redisplay All"		REFRESH
"Exit Suntools"		EXIT

SEE ALSO
sunview(1)