FvwmM4
名称(NAME):
FvwmM4 - FVWM M4预处理器。(M4 是一个宏处理器。将输入拷贝到输出,同时将宏展开。宏可以是内嵌的也可以是用户定义的。除了可以展开宏,m4还有一些内建的函数,用来引用文件,执行Unix命令,整数运算,文本操作,循环等。m4既可以作为编译器的前端也可以单独作为一个宏处理器。)
概要(SYNOPSIS):
Module FvwmM4 [options] filename
FvwmM4 只能被fvwm调用(fork),不能从命令行启动。
描述(DESCRIPTION):
FvwmM4 执行时,将对参数里指定的文件进行M4的预处理,之后,fvwm 将会去执行预处理输出文件里包含的命令。
调用(INVOCATION):
FvwmM4 可以通过.fvwm2rc文件、菜单操作、鼠标操作、或者任何能够执行fvwm命令的任何方式调用。
如果用户希望使用 FvwmM4 预处理自己的.fvwm2rc文件,则应该使用下面的命令启动fvwm:
fvwm -cmd "Module FvwmM4 .fvwm2rc"
注意,选项“-cmd”的参数需要加引号。
FvwmM4 作为一个模块运行时,可以与fvmw异步运行。如果在.fvwm2rc里调用 FvwmM4,则它生成的命令有可能不能够在执行.fvwm2rc文件中的下一条命令时运行。按照下面的命令调用 FvwmM4达到异步的目的:
ModuleSynchronous FvwmM4 -lock filename
选项(OPTIONS):
-m4-prefix
使所有的m4指令要求前缀"m4_"。
-m4-prefix-defines
-m4opt option
传递option到m4程序。
-m4-squote character
-m4-equote character
-m4prog name
使用name指定的程序替代调用“M4”
-outfile filename
指定输出文件的名称。注意,写这个文件前,FvwmM4 会尝试首先删除它,因此不要在它里面保存任何重要的信息,即使已经加上写保护。
-debug
保留M4输出的临时文件。它通常是"/tmp/fvwmrcXXXXXX"
-lock
如果希望使用这个选项,你需要使用ModuleSynchronous来启动 FvwmM4。-lock 使fvwm等待预处理过程结束,并在继续下一步之前,FvwmCpp 会请求fvwm读取预处理过的文件。
-noread
使fvwm 不去读取预处理后的文件。
配置选项(CONFIGURATION OPTIONS):
FvwmM4 定义了一些可以在预处理文件里使用的常量:
TWM_TYPE:
总是“fvwm”
SERVERHOST
运行 X server 的机器名
CLIENTHOST
运行 fvwm 的机器名
HOSTNAME
运行 fvwm 的主机名,通常与CLIENTHOST相同
OSTYPE
CLIENTHOST上的操作系统
USER
运行 fvwm 的用户的名字
HOME
用户主目录
VERSION
X11 版本
REVISION
X11 版本的修订号
VENDOR
X server 厂商
RELEASE
X server版本号
SCREEN
显示屏幕号
WIDTH
屏幕宽度
HEIGHT
屏幕高度
X_RESOLUTION
水平方向上的距离
Y_RESOLUTION
垂直方向上的距离
PLANES
BITS_PER_RGB
CLASS
COLOR
FVWM_CLASS
FVWM_COLOR
FVWM_VERSION
fvwm版本号
OPTIONS
FVWM_MODULEDIR
fvwm 配置文件存放的目录。
FVWM_USERDIR
环境变量 $FVWM_USERDIR 的值
SESSION_MANAGER
环境变量 $SESSION_MANAGER 的值
示例(EXAMPLE PROLOG)
define(TWM_TYPE,``fvwm'')dnl
define(SERVERHOST,``spx20'')dnl
define(CLIENTHOST,``grumpy'')dnl
define(HOSTNAME,``grumpy'')dnl
define(OSTYPE,``SunOS'')dnl
define(USER,``nation'')dnl
define(HOME,``/local/homes/dsp/nation'')dnl
define(VERSION,``11'')dnl
define(REVISION,``0'')dnl
define(VENDOR,``HDS human designed systems, inc. (2.1.2-D)'')dnl
define(RELEASE,``4'')dnl
define(SCREEN,``0'')dnl
define(WIDTH,``1280'')dnl
define(HEIGHT,``1024'')dnl
define(X_RESOLUTION,``3938'')dnl
define(Y_RESOLUTION,``3938'')dnl
define(PLANES,``8'')dnl
define(BITS_PER_RGB,``8'')dnl
define(CLASS,``PseudoColor'')dnl
define(COLOR,``Yes'')dnl
define(FVWM_VERSION,``1.24l'')dnl
define(OPTIONS,``SHAPE XPM M4 '')dnl
define(FVWM_MODULEDIR,``/local/homes/dsp/nation/modules'')dnl
define(FVWM_USERDIR,``/local/homes/dsp/nation/.fvwm'')dnl
define(SESSION_MANAGER,``local/grumpy:/tmp/.ICE-unix/440,tcp/spx20:1025'')dnl