doc/fvwm/scripting.xml

   1 <?xml version="1.0" encoding="UTF-8" ?>
   2 <!DOCTYPE part PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
   3   "../docbook-xml/docbookx.dtd"
   4 [
   5 <!ENTITY % myents SYSTEM "../fvwm.ent" >
   6 %myents;
   7 ]>
   8
   9 <!-- $Id: scripting.xml,v 1.1 2007/03/10 05:15:34 scott Exp $ -->
  10
  11 <section id='scripting_and_complex_functions'>
  12 <title>Scripting &amp; Complex Functions</title>
  13
  14 <para>To achieve the more complex effects, fvwm has a number of
  15 commands that improve its scripting abilities.  Scripts can be
  16 read from a file with
  17 <fvwmref cmd="Read"/>,
  18 from the output of a command with
  19 <fvwmref cmd="PipeRead"/>
  20 or written as a complex function with the
  21 <fvwmref cmd="AddToFunc"/>
  22 command.  For the curious, section 7 of the fvwm FAQ shows some
  23 real life applications of scripting.  Please refer to the sections
  24 <fvwmref sect="userFunctions" opt="user_functions_and_shell_commands" name="User Functions and Shell Commands"/>
  25 and
  26 <fvwmref sect="conditionals" opt="conditional_commands" name="Conditional Commands"/>
  27 for details.  A word of warning:  during execution of complex
  28 functions, fvwm needs to take all input from the mouse pointer
  29 (the pointer is "grabbed" in the slang of X).  No other programs
  30 can receive any input from the pointer while a function is run.
  31 This can confuse some programs.  For example, the xwd program
  32 refuses to make screen shots when run from a complex function.  To
  33 achieve the same functionality you can use the
  34 <fvwmref cmd="Read"/>
  35 or
  36 <fvwmref cmd="PipeRead"/>
  37 command instead.</para>
  38
  39 </section>