NAME
FvwmCpp - the FVWM Cpp pre-processor
SYNOPSIS
FvwmCpp is spawned by fvwm, so no command line
invocation will work.
DESCRIPTION
When called, this module will attempt to have
/usr/lib/cpp pre-process the file specified in its invocation, and
then have fvwm read the resulting file.
INVOCATION
FvwmCpp can be invoked by inserting the line
'FvwmCpp' in the .fvwm2rc file. It can also be called from a menu
or mouse binding. If the user wants his entire .fvwm2rc file
pre-processed with FvwmCpp, then fvwm should be invoked as:
fvwm2 -cmd "FvwmCpp .fvwm2rc"
Some options can be specified on the command line:
- -cppopt option
- Lets you pass an option to the cpp program. Not really needed
as any unknown options will be passed on automatically.
- -cppprog name
- Instead of invoking "/usr/lib/cpp", fvwm will invoke
name.
- -outfile filename
- Instead of creating a random unique name for the temporary file
for the preprocessed rc file, this option will let you specify the
name of the temporary file it will create. Please note that FvwmCpp
will attempt to remove this file before writing to it, so don't
point it at anything important even if it has read-only protection.
- -debug
- Causes the temporary file create by Cpp to be retained. This
file is usually called "/tmp/fvwmrcXXXXXX"
- -lock
- If you want to use this option you need to start FvwmCpp with
ModuleSynchronous. This option causes fvwm to wait that the
pre-process finish and that FvwmCpp asks fvwm to Read the
pre-processed file before continuing. This may be useful at startup
if you use a session manager as Gnome. Also, this is useful if you
want to process and run a Form in a fvwm function.
- -noread
- Causes the pre-processed file to be not read by fvwm. Useful to
pre-process a FvwmScript script with FvwmCpp.