---
name: "FvwmCpp"
section: "6"
platform: "linux"
package: "fvwm95"
version: "2.0.43b-5"
release: "Debian 2.0 (Hamm)"
platforms: ["linux"]
url: "https://new.carta.tech/FvwmCpp/6"
---

# FvwmCpp(6)

the FVWM Cpp pre-processor

## 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 .fvwmrc file. It can also be called from a menu or mouse binding.  If the user wants his entire .fvwmrc file pre-processed with FvwmCpp, then fvwm should be invoked as "fvwm -f /usr/lib/X11/fvwm/FvwmCpp

Some options can be specified on the command line:

- \-Cppopt

  Lets you pass an option to the cpp program.

- \-Cppprog

  Instead of invoking "/usr/lib/cpp", fvwm will invoke *name*.

- \-debug

  Causes the temporary file create by Cpp to be retained. This file is usually called "/tmp/fvwmrcXXXXXX"

## CONFIGURATION OPTIONS

FvwmCpp defines some values for use in the pre-processor file:

- TWM\_TYPE

  Always set to "fvwm".

- SERVERHOST

  The name of the machine running the X Server.

- CLIENTHOST

  The name of the machine running fvwm.

- HOSTNAME

  The hostname of the machine running fvwm. Generally the same as CLIENTHOST.

- OSTYPE

  The operating system for CLIENTHOST.

- USER

  The name of the person running fvwm.

- VERSION

  The X11 version.

- REVISION

  The X11 revision number.

- VENDOR

  The X server vendor.

- RELEASE

  The X server release number.

- WIDTH

  The screen width in pixels.

- HEIGHT

  The screen height in pixels.

- X\_RESOLUTION

  Some distance/pixel measurement for the horizontal direction, I think.

- Y\_RESOLUTION

  Some distance/pixel measurement for the vertical direction, I think.

- PLANES

  Number of color planes for the X server display

- BITS\_PER\_RGB

  Number of bits in each rgb triplet.

- CLASS

  The X11 visual class, ie PsuedoColor.

- COLOR

  Yes or No, Yes if the display class is neither StaticGrey or GreyScale.

- FVWM\_VERSION

  The fvwm version number, ie 2.0

- OPTIONS

  Some combination of SHAPE, XPM, NO\_SAVEUNDERS, and Cpp, as defined in configure.h at compile time.

- FVWMDIR

  The directory where fvwm looks for .fvwmrc and modules by default, as determined at compile time.

## EXAMPLE PROLOG

```
#define TWM_TYPE fvwm
#define SERVERHOST spx20
#define CLIENTHOST grumpy
#define HOSTNAME grumpy
#define OSTYPE SunOS
#define USER nation
#define HOME /local/homes/dsp/nation
#define VERSION 11
#define REVISION 0
#define VENDOR HDS human designed systems, inc. (2.1.2-D)
#define RELEASE 4
#define WIDTH 1280
#define HEIGHT 1024
#define X_RESOLUTION 3938
#define Y_RESOLUTION 3938
#define PLANES 8
#define BITS_PER_RGB 8
#define CLASS PseudoColor
#define COLOR Yes
#define FVWM_VERSION 2.0 pl 1
#define OPTIONS SHAPE XPM Cpp
#define FVWMDIR /local/homes/dsp/nation/modules
```

## AUTHOR

FvwmCpp is the result of a random bit mutation on a hard disk, presumably a result of a  cosmic-ray or some such thing.