Hello,
I noticed earlier that there is a discrepency in the FVWM manpage (2.5.X
series is the only one to be fixed) for the Wait command description. The
description says initially that the command waits of "windowname". This is
parly true -- the code in builtins.c apparently also checks for the window's
tile, class and resource (just like how the style command works).
I feel this needs to be reflected in its description, hence see the patch
file attached with this email -- my groff skills are far from perfect, so I
hope it's accurate. If not, let me know and I will ammend it for you.
Note that in the function example accompanying the Wait command's
description, I have taken the liberty of replacing the function's use of the
"Desk" command with "GotoDesk" since this is now the preferred command to use.
Note also that I feel the entire function example needs rewriting. I am
hoping that in some future FVWM version that the use of InitFunction will be
completely deprecated in favour of using StartFunction explicitly and testing
conditions via: Test (Init) Some_Command.
I've also replaced the use of 'windowname' to 'windowtitle' since the XAtom
WM_TITLE is apparent. The name really ought to be "windowtitle".
-- Thomas Adam
--
ThisWindow (thomas_adam) Destroy
--- ./fvwm.1.in.orig 2006-07-28 00:24:09.000000000 +0100
+++ ./fvwm.1.in 2006-07-28 00:58:01.000000000 +0100
@@ -10297,22 +10297,26 @@
started directly by fvwm.
.TP
-.BI "Wait " windowname
+.BI "Wait [" windowtitle | windowclass | windowresource "]"
This command is intended to be used in fvwm functions only. It
causes execution of a function to pause until a new window with
-the title
-.I windowname
-appears. This is particularly useful in the "InitFunction" if you
-are trying to start windows on specific desktops:
+either the
+.I windowtitle
+or
+.I windowclass
+or
+.I windowresource
+(in that order) appears. This is particularly useful in the
+"InitFunction" if you are trying to start windows on specific desktops:
.EX
AddToFunc InitFunction
+ I Exec exec xterm -geometry 80x64+0+0
+ I Wait xterm
- + I Desk 0 2
+ + I GotoDesk 0 2
+ I Exec exec xmh -font fixed -geometry \\
507x750+0+0
+ I Wait xmh
- + I Desk 0 0
+ + I GotoDesk 0 0
.EE
The above function starts an xterm on the current desk, waits for
it to map itself, then switches to desk 2 and starts an xmh.
