cvsimport
[fvwm-themes.git] / bin / fvwm-themes-start.1
blob0c6e380c82887620285a5aee20f0aa8e2fe7ca2f
1 .TH FVWM-THEMES-START 1 "15/Aug/2000" "Fvwm Utility"
2 .SH "NAME"
3 fvwm-themes-start \- FVWM Themes starter
4 .SH "SYNOPSIS"
5 \fBfvwm-themes-start\fR
6 [ \fB--session\fR|\fB\-s\fR name ] [ \fB--no-start|-n\fR ] 
7 [ \fB--fvwm-exe|-e\fR ] [ \fB--\fR fvwm-args ]
9 .SH "DESCRIPTION"
10 This script runs fvwm with FVWM Themes.  It should be run under X.
11 Put a call to this script as the last line of your .Xclients, .xinitrc
12 or .xsession file.
14 .SH "OPTIONS"
15 \fB--session\fR name \- name of the FVWM Themes session. By default it
16 is "main". This allows to have and run different FVWM Themes configuration.
18 \fB--no-start\fR - do not start fvwm, just do preparation for starting it.
19 This is useful to start FVWM Themes with a session manager, see FAQ.
21 \fB--fvwm-exe\fR - changes the default executable, which is \fIfvwm\fR
22 or whatever \fIfvwm-config --fvwm-exe\fR returns.
24 \fB--\fR everything after \fB--\fR is passed to FVWM.
25 See the \fBfvwm\fR(1) man page for the fvwm options.
27 .SH "EXAMPLES"
28 Most users just should put:
29 .nf
30 .sp
31         fvwm-themes-start
32 .sp
33 .fi
34 as the last line of their .Xclients, .xinitrc or .xsession file.
35 If you want to use FVWM Themes with a real session manager, say
36 GNOME, you need to use the --no-start option and put:
37 .nf
38 .sp
39         fvwm-themes-start --no-start
40         gnome-session
41 .sp
42 .fi
43 as the last lines of your .Xclients, .xinitrc or .xsession file.
44 The session option allows to use FVWM Themes with different configurations.
45 Say, you want to use 3 different configurations under a normal FVWM session
46 when FOO test is false, under gnome-session and under a normal FVWM session
47 when FOO test is true. Then, your .xinitrc/.xsession file may look
48 as follows (where $1 is the "first" argument given by startx, or by kdm or 
49 gdm ...):
50 .nf
51 .sp
52         ...
53         case $1 in
54           fvwm)
55             if FOO; Then 
56               fvwm-themes-start --session special 
57             else
58               fvwm-themes-start 
59        fi
60           ;;
61           gnome)
62             fvwm-themes-start --session gnome --no-start
63             gnome-session
64           ;; 
65           ... other cases ...
66         esac            
67 .sp
68 .fi
69 Note that with most session managers (e.g., GNOME or XSM) it is
70 preferable to give "fvwm -f themes-rc" as the starting window manager
71 command in the session manager.
73 .SH "COPYING"
74 The script is distributed by the same terms as fvwm-themes itself.
75 See GNU General Public License for details.
77 .SH "BUGS"
78 Report bugs to fvwm-themes-devel@lists.sourceforge.net.