1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
|
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE part PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"../docbook-xml/docbookx.dtd"
[
<!ENTITY % myents SYSTEM "../fvwm.ent" >
%myents;
]>
<!-- $Id$ -->
<section id='Restart'>
<title>Restart</title>
<cmdsynopsis>
<command>Restart</command
><arg choice='opt'
><replaceable>window_manager</replaceable
><arg choice='opt'
><replaceable>params</replaceable
></arg>
</arg>
</cmdsynopsis>
<para>Causes fvwm to restart itself if
<replaceable>window_manager</replaceable>
is left blank, or to switch to an alternate window manager (or
other fvwm version) if
<replaceable>window_manager</replaceable>
is specified. If the window manager is not in your default search
path, then you should use the full path name for
<replaceable>window_manager</replaceable>.</para>
<para>This command should not have a trailing ampersand. The command
can have optional parameters with simple shell-like syntax. You
can use
<filename>~</filename>
(is expanded to the user's home directory) and environmental
variables
<envar>$VAR</envar> or <envar>${VAR}</envar>.
Here are several examples:</para>
<programlisting>
<fvwmref cmd="Key"/> F1 R N Restart
<fvwmref cmd="Key"/> F1 R N Restart fvwm -s
<fvwmref cmd="Key"/> F1 R N Restart ~/bin/fvwm -f $HOME/.fvwm/main
<fvwmref cmd="Key"/> F1 R N Restart fvwm1 -s -f .fvwmrc
<fvwmref cmd="Key"/> F1 R N Restart xterm -n '"X console"' \
-T \"X\ console\" -e fvwm1 -s
</programlisting>
<para>If you need a native restart, we suggest only to use
<emphasis remap='B'>Restart</emphasis>
command without parameters unless there is a reason not to. If you
still use an old command 'Restart fvwm2' that was correct in 2.2.x,
all current command line arguments are lost. On a restart without
parameters or with --pass-args, they are preserved. Here are some
cases when 'Restart fvwm2' or 'Restart fvwm' cause troubles:</para>
<programlisting>
* running fvwm under a session manager
* running fvwm with multi headed displays
* having command line arguments, like
-f themes-rc or -cmd
* if the first fvwm2 in the $PATH is a
different one
</programlisting>
<para>This is why we are issuing a warning on an old usage. If you
really want to restart to fvwm with no additional arguments, you
may get rid of this warning by using "Restart fvwm -s" or
"Restart /full/path/fvwm".</para>
<para>Note, currently with multi headed displays, restart of fvwms on
different screens works independently.</para>
<cmdsynopsis>
<command>Restart</command
><arg choice='plain'
><option>--pass-args</option
></arg
><arg choice='plain'
><replaceable>window_manager</replaceable
></arg>
</cmdsynopsis>
<para>The same as
<emphasis remap='B'>Restart</emphasis>
without parameters but the name for the current window manager is
replaced with the specified
<replaceable>window_manager</replaceable>
and original arguments are preserved.</para>
<para>This command is useful if you use initial arguments like</para>
<programlisting>
-cmd FvwmCpp
</programlisting>
<para>and want to switch to another fvwm version without losing the
initial arguments.</para>
<cmdsynopsis>
<command>Restart</command
><arg choice='plain'
><option>--dont-preserve-state</option
></arg
><arg choice='opt'
><replaceable>other-params</replaceable
></arg>
</cmdsynopsis>
<para>The same as</para>
<programlisting>
<emphasis remap='B'>Restart</emphasis> <optional><replaceable>other-params</replaceable></optional>
</programlisting>
<para>but it does not save any window states over the restart.</para>
<para>Without this option,
<emphasis remap='B'>Restart</emphasis>
preserves most per-window state by writing it to a file named
<filename>.fs-restart-<envar>$HOSTDISPLAY</envar></filename>
in the user's home directory.</para>
</section>
|
