1.\" wmanager(1)
2.\"
3.\" Copyright (C) 2000  Tommi Virtanen <tv@debian.org>
4.\" Copyright (C) 2008  Peter Pentchev <roam@ringlet.net>
5.\"
6.\" This program is free software; you can redistribute it and/or modify
7.\" it under the terms of the GNU General Public License as published by
8.\" the Free Software Foundation; either version 2 of the License, or
9.\" (at your option) any later version.
10.\"
11.\" This program is distributed in the hope that it will be useful,
12.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
13.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14.\" GNU General Public License for more details.
15.\"
16.\" You should have received a copy of the GNU General Public License
17.\" along with this program; if not, write to the Free Software
18.\" Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
19.\"
20.Dd May 22, 2008
21.Dt WMANAGER 1
22.Os
23.Sh NAME
24.Nm wmanager
25.Nd choose a window manager and launch it
26.Sh SYNOPSIS
27.Nm
28.Op Ar OPTIONS ...
29.Sh DESCRIPTION
30The
31.Nm
32program displays a choice of the window managers listed in the
33.Pa ~/.wmanagerrc
34file.
35When one is picked, the related command is written
36to standard output, intended to be used by shell scripts.
37If the
38program is exited without choosing a window manager,
39.Dq -1
40is written
41to standard output.
42.Pp
43.Bl -tag -width indent
44.It Fl fg Ar COLOR
45Set the foreground color.
46.It Fl bg Ar COLOR
47Set the background color.
48.It Fl bg2 Ar COLOR
49Set the widget background color
50.It Fl di[splay] Ar host:n.n
51Set the X display.
52.It Fl dn[d] , Fl nod[nd]
53Enable/disable drag & drop, probably does nothing.
54.It Fl g[eometry] Ar WxH+X+Y
55Set the window size and location.
56.It Fl i[conic]
57Start as iconified.
58.It Fl k[bd] , Fl nok[bd]
59Enable/disable keyboard support.
60.It Fl na[me] Ar CLASSNAME
61Set the X window class.
62.It Fl s[cheme] Ar SCHEME
63Unknown, probably does nothing useful.
64.It Fl ti[tle] Ar WINDOWTITLE
65Set the window title.
66.It Fl to[oltips] , Fl not[ooltips]
67Enable/disable tooltips, probably does nothing.
68.El
69.Sh EXAMPLE
70To start using
71.Nm ,
72create a
73.Pa ~/.wmanagerrc
74file - generally with
75.Xr wmanagerrc-update 1
76- and add something like the following at the end of your
77.Pa ~/.xsession
78file:
79.Pp
80.Dl WM="$(wmanager -geometry +570+585)"
81.Dl ...
82.Dl exec "$WM"
83.Pp
84See also
85.Xr wmanager-loop 1
86for a nicer way to start
87.Nm .
88.Sh SEE ALSO
89.Xr wmanager 1 ,
90.Xr wmanager-loop 1 ,
91.Xr wmanagerrc-update 1 ,
92.Xr X 7x
93.Sh HISTORY
94The
95.Nm
96program was written by
97.An Meik Tessmer
98in 1999.
99This manual page was originally written in perldoc format by
100.An Tommi Virtanen
101in 2000, and converted to mdoc format by
102.An Peter Pentchev
103in 2008.
104.Sh AUTHORS
105The
106.Nm
107program -
108.An -nosplit
109.An Meik Tessmer
110.Aq fuller@daemogorgon.net .
111.Pp
112The manual page -
113.An Tommi Virtanen
114.Aq tv@debian.org
115and
116.An Peter Pentchev
117.Aq roam@ringlet.net .
118