File: scripting.xml

package info (click to toggle)
fvwm 1%3A2.7.0-3
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 15,968 kB
  • sloc: ansic: 145,836; xml: 17,096; perl: 7,237; sh: 5,100; makefile: 1,101; yacc: 688; lex: 187; sed: 11
file content (39 lines) | stat: -rw-r--r-- 1,451 bytes parent folder | download | duplicates (5)
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
<?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='scripting_and_complex_functions'>
<title>Scripting &amp; Complex Functions</title>

<para>To achieve the more complex effects, fvwm has a number of
commands that improve its scripting abilities.  Scripts can be
read from a file with
<fvwmref cmd="Read"/>,
from the output of a command with
<fvwmref cmd="PipeRead"/>
or written as a complex function with the
<fvwmref cmd="AddToFunc"/>
command.  For the curious, section 7 of the fvwm FAQ shows some
real life applications of scripting.  Please refer to the sections
<fvwmref sect="userFunctions" opt="user_functions_and_shell_commands" name="User Functions and Shell Commands"/>
and
<fvwmref sect="conditionals" opt="conditional_commands" name="Conditional Commands"/>
for details.  A word of warning:  during execution of complex
functions, fvwm needs to take all input from the mouse pointer
(the pointer is "grabbed" in the slang of X).  No other programs
can receive any input from the pointer while a function is run.
This can confuse some programs.  For example, the xwd program
refuses to make screen shots when run from a complex function.  To
achieve the same functionality you can use the
<fvwmref cmd="Read"/>
or
<fvwmref cmd="PipeRead"/>
command instead.</para>

</section>