.TH CHOOSEWM 1 "2009-06-11" .SH NAME choosewm \- Select a window manager to be used. .SH SYNOPSIS .B choosewm .RB [ -f "] [" -p "] [" -t ] .br .BR choosewm " [" -t "] " -c .SH DESCRIPTION .B choosewm presents a window to let the user choose a window manager to start. By default it shows everything registered as window manager at the Debian menu system, but it allows global and local configuration to change that data. .SH OPTIONS .TP .B \-c, \-\-config Allow the user to change the default. Beside telling choosewm to not start the chosen window manger, this mostly changes the text of some buttons and labels .TP .B \-f, \-\-force Show the selection window unconditionally. .TP .B \-p, \-\-print Do not start the window-manager, but print it to stdout. .TP .B \-t, \-\-text Do not ask by opening an X11 window, but ask on the terminal. Needs a terminal as stdin. This is activated by default with \fB\-c\fP and \fBDISPLAY\fP not set. .SH CONFIG FILES After reading \fB/var/lib/choosewm/windowmanagers\fP, treating anything before a equal (\fB=\fP) sign in a line a name and everything after that as window manager path, .B choosewm checks \fB/etc/X11/choosewm/config\fP and after that by default \fB.choosewm/config\fP in the user's $HOME-directory. Lines containing only spaces or starting with a # are ignored. Every other line may contain one of the following commands: .TP .B add: \fIname\fP=\fIpath\fP Add an additional window manager to the list. \fIname\fP will be shown in the list, \fIpath\fP will be started. This option is only useful to add something that should be only added to this list. If you installed a window manager by hand, please consider to register it in the Debian menu instead. That way all potent enough window managers will be able to offer switching to that window manager by menu. .TP .B remove: \fIpath\fP Do not list the window manager with \fIpath\fP in the list to choose from. .TP .B default: \fIdefaultwindowmanagerpath\fP Use the window manager \fIdefaultwindowmanagerpath\fP as default, when no last selection of the window manager is available. .TP .B userconf: \fIfilename\fP Read the user's config from \fB$(HOME)/\fP\fIfilename\fP. If \fIfilename\fP is \fB-\fP, no user config is read. Default is \fB.choosewm/config\fP .TP .B dontaskfile: \fIfilename\fP Create the file \fB$(HOME)/\fP\fIfilename\fP, if the user selected to not be asked about the window manger, and do not ask if this file is present. (Unless \fB-f\fP is command line argument.) Default is \fB.choosewm/dontask\fP .TP .B lastdecisionfile: \fIfilename\fP Read the last decision from the file \fB$(HOME)/\fP\fIfilename\fP, and save the decision of the user there. Default is \fB.choosewm/lastwm\fP .TP .B inalias: \fIoldold\fP=\fInewpath\fP If the last decision is \fIoldpath\fP, change it to \fInewpath\fP. .TP .B askalias: \fIoldold\fP=\fInewpath\fP If the last decision is \fIoldpath\fP, change it to \fInewpath\fP and force showing of the selection window. .TP .B outalias: \fIpath\fP=\fIoutput\fP If the user has chosen \fIpath\fP as window manager, write instead \fIoutput\fP to the file as new last decision. .TP .B s\fITAG\fP: \fItext\fP Are used to set strings to be shown to the user in labels, buttons or headers. The \fBCONFIG\fP\fITAG\fP variants are used with \fB\-c\fP. The following are the currently definied Tags and their default values: .br .B sCONFIGHEADER: \fRChoose default Window Manager\fP .br .B sHEADER: \fRChoose Window Manager\fP .br .B sCONFIGWELCOME: \fRPlease choose the default window manager and whether to reask at start time.\fP .br .B sWELCOME: \fRWelcome, please select a Window manager to use.\fP .br .B sCONFIGASK: \fR_Ask when starting\fP .br .B sASK: \fR_Ask again at every login\fP .br .B sCONFIGSELECT: \fR_Select\fP .br .B sSELECT: \fR_Start\fP .br .B sCONFIGCANCEL: \fR_Cancel\fP .br .B sCANCEL: \fR_Log out\fP .SH ENVIRONMENT VARIABLES .TP .B HOME The current home directory of the current user. .TP .B DEFAULTWINDOWMANAGER If no default is specified in the config files nor by the user's last choice, the content of this environment variable is tried before the path \fB/etc/alternatives/x-window-manager\fP is pointing to is tried. .SH FILES .TP .B /etc/X11/choosewm/config Global config file read. .TP .B /var/lib/choosewm/windowmanagers Default system window manager file. .TP .B /etc/alternatives/x-window-manager Default link to compute a default. .TP .B $(HOME)/.choosewm/config Default user config file. .TP .B $(HOME)/.choosewm/lastwm Default file to store the users default. .TP .B $(HOME)/.choosewm/dontask Default file to signal not asking when existant. .SH SEE ALSO .BR update-menus (1), .BR xsession (1). .SH AUTHOR choosewm was written by Bernhard R. Link . .PP This manual page was written by Bernhard R. Link.