NAME¶

fvwm-config - query an existing fvwm installation

SYNOPSIS¶

fvwm-config [--help] [--version] [--info] [--prefix] [--exec-prefix] [--bindir] [--datadir] [--libexecdir] [--sysconfdir] [--mandir] [--localedir] [--fvwm-moduledir] [--fvwm-datadir] [--fvwm-perllibdir] [--default-imagepath] [--default-userdir] [--fvwm-exe] [--supports] [--supports-<feature>] [--is-final] [--is-stable] [--release-date]

DESCRIPTION¶

fvwm-config is a shell script that provides an information about the fvwm version, installation directories, built-in paths and supported features.

OPTIONS¶

fvwm-config prints to the standard output in all options. Both short and long GNU-like option names may be used.

-h --help -?

prints the short usage

-v --version -V

prints the version

-i --info

prints the full info page

-P --prefix

prints the installation prefix

-E --exec-prefix

prints the installation exec-prefix

-B --bindir

prints the installation bindir

-D --datadir

prints the installation datadir

-L --libexecdir

prints the installation libexecdir

-S --sysconfdir

prints the installation sysconfdir

-M --mandir

prints the installation mandir

-O --localedir

prints the installation localedir

-m --fvwm-moduledir

prints FVWM_MODULEDIR, where the modules are installed

-d --fvwm-datadir

prints FVWM_DATADIR, where the system wide configs are installed

-p --fvwm-perllibdir

prints FVWM_PERLLIBDIR, where the perl library is installed

-I --default-imagepath

prints the built-in ImagePath

-U --default-userdir

prints the default FVWM_USERDIR, note: $HOME is not expanded

-e --fvwm-exe

prints the fvwm executable name (in bindir)

-s --supports

lists all supported features, one per line

--supports-<feature>

prints nothing, returns: 0 if the <feature> is supported, 100 if not, 200 if unknown. All or supported feature names may be found using --info or --supports respectively.

--is-final

prints "yes" for final releases and "no" for cvs snapshots

--is-stable

prints "yes" for the stable branch and "no" otherwise

--release-date

prints the release date if the release is final

USAGE¶

Here are some real life usages. Checks for xft support:

if fvwm-config --supports-xft;
  then echo 1; else echo 0; fi

fvwm-themes package checks for the correct fvwm version installed using:

fvwm-config --version

and tries to use the same installation directories:

fvwm-config --bindir --mandir --fvwm-datadir

A way to find the full path to the fvwm executable:

echo `fvwm-config --bindir`/`fvwm-config --fvwm-exe`

A way to start modules in perl:

use lib `fvwm-config -p | tr -d '0`;
use FVWM::Module;

For a more human readable output, try:

fvwm-config --info

COPYING¶

fvwm-config is a part of fvwm package and distributed by the same terms, see GNU GPL.

AUTHOR¶

Mikhael Goikhman <migo@homemail.com>