File: Silent.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 (62 lines) | stat: -rw-r--r-- 1,909 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
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>