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
|
<?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: ModuleSynchronous.xml,v 1.3 2007/06/16 12:38:46 griph Exp $ -->
<section id='ModuleSynchronous'>
<title>ModuleSynchronous</title>
<cmdsynopsis>
<command>ModuleSynchronous</command
><arg choice='opt'
>Expect <replaceable>string</replaceable
></arg
><arg choice='opt'
>Timeout <replaceable>secs</replaceable
></arg
><arg choice='plain'
><replaceable>modulename</replaceable
></arg>
</cmdsynopsis>
<para>The
<emphasis remap='B'>ModuleSynchronous</emphasis>
command is very similar to
<fvwmref cmd="Module"/>.
Fvwm stops processing any commands and user input until the module
sends a string beginning with "NOP FINISHED STARTUP" back to fvwm.
If the optional
<fvwmopt cmd="ModuleSynchronous" opt="Timeout"/>
is given fvwm gives up if the module sent no input back to fvwm
for
<replaceable>secs</replaceable>
seconds. If the
<fvwmopt cmd="ModuleSynchronous" opt="Expect"/>
option is given, fvwm waits for the given
<replaceable>string</replaceable>
instead.
<emphasis remap='B'>ModuleSynchronous</emphasis>
should only be used during fvwm startup to enforce the order in
which modules are started. This command is intended for use with
the (currently hypothetical) module that should be in place before
other modules are started.</para>
<para>Warning: It is quite easy to hang fvwm with this command, even if
a timeout is given. Be extra careful choosing the string to wait
for. Although all modules in the fvwm distribution send back the
"NOP FINISHED STARTUP" string once they have properly started up,
this may not be the case for third party modules. Moreover, you
can try to escape from a locked
<emphasis remap='B'>ModuleSynchronous</emphasis>
command by using the key sequence
<keysym>Ctrl-Alt-Escape</keysym>
(see the
<fvwmref cmd="EscapeFunc"/>).</para>
</section>
|
