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
|
<?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='Silent'>
<title>Silent</title>
<cmdsynopsis>
<command>Silent</command
><arg choice='plain'
><replaceable>command</replaceable
></arg>
</cmdsynopsis>
<para>A number of commands require a window to operate on. If
no window was selected when such a function is invoked the user is
asked to select a window. Sometimes this behavior is unwanted,
for example if the function was called by a module and the window
that was selected at first does not exist anymore. You can
prevent this by putting
<emphasis remap='B'>Silent</emphasis>
in front of the fvwm
<replaceable>command</replaceable>.
If a function that needs a window is called with
<emphasis remap='B'>Silent</emphasis>
without a window selected, it simply returns without doing
anything. If
<emphasis remap='B'>Silent</emphasis>
is used on a user defined function it affects all function and sub
function calls until the original function exits.</para>
<para>Another usage of
<emphasis remap='B'>Silent</emphasis>
is with binding commands
<fvwmref cmd="Key"/>, <emphasis remap='B'>PointerKey</emphasis> and <emphasis remap='B'>Mouse</emphasis>,
this disables error messages.</para>
<para><emphasis remap='B'>Silent</emphasis>
also disables the error message for non-existent commands. Note:
This command is treated as a prefix to its
<replaceable>command</replaceable>.
Expansion of the command line is done as if
<emphasis remap='B'>Silent</emphasis>
was not there.</para>
<para>Examples:</para>
<programlisting>
Silent <fvwmref cmd="Move"/> 0 0
Silent User_defined_function
# do not complain on keyboards without "Help" key
Silent <fvwmref cmd="Key"/> Help R A <fvwmref cmd="Popup"/> HelpMenu
</programlisting>
</section>
|