1libXpm - X Pixmap (XPM) image file format library
2-------------------------------------------------
3
4All questions regarding this software should be directed at the
5Xorg mailing list:
6
7  https://lists.x.org/mailman/listinfo/xorg
8
9The primary development code repository can be found at:
10
11  https://gitlab.freedesktop.org/xorg/lib/libXpm
12
13Please submit bug reports and requests to merge patches there.
14
15For patch submission instructions, see:
16
17  https://www.x.org/wiki/Development/Documentation/SubmittingPatches
18
19------------------------------------------------------------------------------
20
21libXpm supports two optional features to handle compressed pixmap files.
22
23--enable-open-zfile makes libXpm recognize file names ending in .Z and .gz
24and open a pipe to the appropriate command to compress the file when writing
25and uncompress the file when reading. This is enabled by default on platforms
26other than MinGW and can be disabled by passing the --disable-open-zfile flag
27to the configure script.
28
29--enable-stat-zfile make libXpm search for a file name with .Z or .gz added
30if it can't find the file it was asked to open.  It relies on the
31--enable-open-zfile feature to open the file, and is enabled by default
32when --enable-open-zfile is enabled, and can be disabled by passing the
33--disable-stat-zfile flag to the configure script.
34
35All of these commands will be executed with whatever userid & privileges the
36function is called with, relying on the caller to ensure the correct euid,
37egid, etc. are set before calling.
38
39To reduce risk, the paths to these commands are now set at configure time to
40the first version found in the PATH used to run configure, and do not depend
41on the PATH environment variable set at runtime.
42
43To specify paths to be used for these commands instead of searching $PATH, pass
44the XPM_PATH_COMPRESS, XPM_PATH_UNCOMPRESS, and XPM_PATH_GZIP
45variables to the configure command.
46