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
63
64
65
66
67
68
69
70
71
72
73
|
<?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: ImagePath.xml,v 1.3 2007/06/16 12:38:46 griph Exp $ -->
<section id='ImagePath'>
<title>ImagePath</title>
<cmdsynopsis>
<command>ImagePath</command
><arg choice='plain'
><replaceable>path</replaceable
></arg>
</cmdsynopsis>
<para>Specifies a colon separated list of directories in which to search
for images (both monochrome and pixmap). To find an image given
by a relative pathname, fvwm looks into each directory listed in
turn, and uses the first file found.</para>
<para>If a directory is given in the form "/some/dir;.ext", this means
all images in this directory have the extension ".ext" that should
be forced. The original image name (that may contain another
extension or no extension at all) is not probed, instead ".ext" is
added or replaces the original extension. This is useful, for
example, if a user has some image directories with ".xpm" images
and other image directories with the same names, but ".png"
images.</para>
<para>The
<replaceable>path</replaceable>
may contain environment variables such as
<envar>$HOME</envar> (or <envar>${HOME}</envar>).
Further, a '+' in the
<replaceable>path</replaceable>
is expanded to the previous value of the path, allowing appending
or prepending to the path easily.</para>
<para>For example:</para>
<programlisting>
ImagePath $HOME/icons:+:/usr/include/X11/bitmaps
</programlisting>
<para>Note: if the
<fvwmref mod="FvwmM4"/>
module is used to parse your
<filename>config</filename>
files, then m4 may want to mangle the word "include" which
frequently shows up in the
<emphasis remap='B'>ImagePath</emphasis>
command. To fix this one may add</para>
<programlisting>
undefine(`include')
</programlisting>
<para>prior to the
<emphasis remap='B'>ImagePath</emphasis>
command, or better: use the
<option>-m4-prefix</option>
option to force all
<emphasis remap='B'>m4</emphasis>
directives to have a prefix of "m4_" (see the
<fvwmref mod="FvwmM4"/>
man page).</para>
</section>
|
