DragonFly On-Line Manual Pages
FVWM-THEMES-CONFIG(1) FVWM Utility FVWM-THEMES-CONFIG(1)
NAME
fvwm-themes-config - fvwm-themes manager and configurator
SYNOPSIS
fvwm-themes-config [ --help|-h ] [ --version|-v ] [ --info|-i ] [
--site ] [ --pipe ] [ --show-themes ] [ --show-components ] [
--show-dir ] [ --theme|-t theme ] [ --show-info ] [ --show-cfg ] [
--show-value key ] [ --component component ] [ --only-site ] [
--only-user ] [ --fvwmscript ] [ --expand-rc|-e [file] ] [ --fresh|-fr
] [ --reset|-r ] [ --no-cfg-cache ] [ --load|-l component@theme ] [
--drop|-u component@theme ] [ --option|-o component:option=value ] [
--variant|-v component=variant ] [ --set-locked component=0|1 ] [
--install|-i file ... ] [ --force-install|-fo ] [ --create-pack name
file ...] [ --pack-prefix prefix ] [ --pack-extra-version x.x ] [
--tmp-dir dir ] [ --com-mode ] [ --com-name name ]
DESCRIPTION
This scripts creates and changes fvwm configuration to use with fvwm-
themes accordingly to theme component definitions and user choices.
It builds themes-rc in $FVWM_USERDIR, which is a replacement for
.fvwm2rc.
OPTIONS
--help - show the help and exit
--version - show the version and exit
--info - show the configured information and exit
--site - use site configuration directory for output. The default is to
use the user's directory.
--pipe - generate fvwm commands suitable to use within fvwm's PipeRead
(instead of error messages, for example).
--show-themes - shows list of all themes (or ones specified by
--theme).
--show-components - shows all themes (or ones specified by --theme)
with all their components (components are TAB justified).
--show-dir - shows the theme directory of all themes (or ones specified
by --theme). These directories sit in themes/ parent directory of
either user or site place.
--theme theme - only theme(s) given by this parameter are queried, if
given. Several instances of --theme may be given. By default all
themes are queried.
--show-info - shows an info for the component given in "--component"
parameter.
--show-cfg - shows an entire configuration hash for the component given
in "--component" parameter. To show only one or several specified named
values, --show-value may be used.
--show-value key - shows a value by the key for the component given in
"--component" parameter. Several instances of --show-value may be
given.
--component component - a working component for other parameters, may
be of form component@theme.
Example:
fvwm-themes-config --component colors --show-value theme --show-value
read-file
--only-site - when specified together with --show-themes or
--show-components causes to take into account only the site directory.
--only-user - when specified together with --show-themes or
--show-components causes to take into account only the user directory.
--fvwmscript - when specified together with --show-themes or
--show-components causes the output to be formatted for FvwmScript.
--expand-rc [file] - gets an FVWM configuration file and expands all
includes in one very long file, printed to standard output. If the file
is not given $FVWM_USERDIR/themes-rc is taken. This parameter can't be
used with others.
--fresh - refresh (regenerate) the fvwm configuration files needed to
load themes, this includes files in the user's directory:
$FVWM_USERDIR/themes-rc, $FVWM_USERDIR/themes-rc-2 and
$FVWM_USERDIR/themes/current/theme.cfg.
--reset - forget all the currently used components, use the components
from the default theme and regenerate the user's configuration cache.
--no-cfg-cache - don't use the existing configuration cache file, this
file will be regenerated.
--set-minimal-reload value - if value is 1, then minimal theme
switching is used, if value is 0, then full theme switching is used.
--load component - multiple "--load" parameters may be given. If the
parameter is of form component@theme, this specific theme component is
used, if it is of form @theme, all components of the given theme will
be used.
The process of "loading" components consists of adding new components
or replacing existing ones in the current theme. It is possible that
there will be conflicts during this operation. In this case, nothing is
changed, negative status is returned and the error message is printed.
--drop component - the opponent for "--load", these parameters may be
mixed. Tries to unload the given component without breaking
dependancies. [@theme] part of component name may be omitted.
--option component:option=value - set another component option value.
The option may be either the option name or its index in the option
list starting from 1 (use 0 to represent the default option). The
value may be either the value name or its index in the option value
list starting from 1 (use 0 to represent the default option value).
--variant component=variant - set another component variant if a given
component has variants. The variant may be either the variant name or
its index in the variant list starting from 1 (use 0 to represent the
default component variant).
--set-locked component=value - set (if value is 1) or unset (if value
is 0) a locked state of the given component. When the component from
the current theme is locked, "--load @theme" will not replace it, it
can only be replaced by explicit "--load component@theme".
Five last parameters may be combined together and multiple parameters
are possible. If --load and --drop parameters are given, first it will
be unloaded all given components and then loaded all given components,
not vice versus. After that --variant and --option parameters will take
place, i.e. it is possible to load a component and immediately change
its options.
--install theme.tar.{gz,bz2} ... - install the specified tarballs into
the site (if --site is alos given) or into the user's themes directory
by verifying and unpacking the contents of the tarballs.
--force-install - during the installation of a theme remove existing
theme with the same name without prompting.
--create-pack pack theme1 theme2 ... - create a gzipped tarball named
ft-pack-VERSION.tar.gz made of the specified theme(s) found in the
user's themes directory or in the site directory if --site is also
given. VERSION is the version of FVWM Themes.
--pack-prefix prefix - replace "ft" by "prefix" in the name of the
gzipped tarball created via the --create-pack option.
--pack-extra-version x.x - add _x.x to VERSION in the name of the
gzipped tarball created via the --create-pack option.
--tmp-dir dir - full path to a directory that can be use as a temporary
working directory. Default is /tmp. This option is used only with
--create-pack.
--com-mode - run fvwm-themes-config under the "communication mode".
See, the fvwm-themes-com and fvwm-themes-menuapp manual pages for more
information on this option. You need to read the code to know the
communication commands.
--com-name name - use name as name for communication with
fvwm-themes-com. By default, "config" is used, but you should use
"config-pid" as name where pid is the pid of the program that want to
talk to fvwm-themes-config so that fvwm-themes-config can exit if this
program exit and so that fvwm-themes-config can kill the program if an
internal error happen in fvwm-themes-config. On the other hand, if you
want to talk with fvwm-themes-config in, say, a terminal you must not
give an name as "config-an_integer" as name.
USAGE
Usually you don't need to run this script manually, it is called using
different interfaces (menus and more).
To start with fvwm-themes, run this:
fvwm-themes-config --reset
This command automatically called in fvwm-themes-start when needed, it
will create the "current" theme in the user space, equivalent to the
"default" one. If "--site" parameter is also given, it will be created
in the system space instead.
Info examples:
fvwm-themes-config --show-themes # shows a list of all themes
fvwm-themes-config --show-components # show all themes+components
fvwm-themes-config --show-themes --component windowlook
fvwm-themes-config --show-components --theme migo --theme default
fvwm-themes-config --component colors \
--show-value theme --show-value read-file
fvwm-themes-config --component colors@cde --show-value option
fvwm-themes-config --component _core --show-value memory
Other examples:
fvwm-themes-config --load @afterstep # load theme "afterstep"
fvwm-themes-config --drop modules@afterstep # unload component
fvwm-themes-config --variant settings/stroke=2 # turn on stroke
fvwm-themes-config --variant settings/stroke=0 # use default (1)
fvwm-themes-config --option bindings:switch-mouse-2-3=no
fvwm-themes-config --set-locked colors=1 --set-locked globalfeel=0
fvwm-themes-config --install --site metallic.tar.gz wooden.tar.gz
fvwm-themes-config --create-pack martyns -tmp-dir . metallic wooden
AUTHORS
Mikhael Goikhman <migo@homemail.com>, 31 Dec 1999.
Olivier Chapuis <olivier.chapuis@free.fr> (some small things and the
communication loop implementation).
COPYING
The script is distributed by the same terms as fvwm-themes itself. See
GNU General Public License for details.
BUGS
Report bugs to fvwm-themes-devel@lists.sourceforge.net.
perl v5.8.1 2003-10-20 FVWM-THEMES-CONFIG(1)