Manpages

NAME

subst - 替换文件中的定义

总览 (SYNOPSIS)

subst [ -e editor ] -f substitutions victim ...

描述 (DESCRIPTION)

Subst 能够替换文件的内容 , 适用于针对本地情况定制软件 . 它根据 substitutions 的内容 , 修改每一个 victim 文件 . 在 substitutions 文件中 , 每个替换说明 (substitution) 占用一行 . 每一行包含两个域 , 用一个或多个 tab 符隔开 . 第一个域是替换说明的 名字 (name), 第二个域是它的 值 (value). 两者均不应该包含 ’’#’’ 字符 ; 而使用文本编辑器的转义符 , 如 ’’&’’ 和 ’’\’’, 也是不明智地 ; 名字最好限制在字母和数字中 ; 以 ’’#’ 开始的行是注释 , 将被忽略 . 在 victim 文件中 , 每一个需要替换的行 (目标行 ) 必须跟在 原形行 (prototype line) 后面 . 原形行应该有这样的限制 : 将来其他程序处理这个文件的时候 , 它被视为注释 . 原形行必须包含目标行的 "原形 ", 该 "原形 " 用 ’’=()<’’ 和 ’’>()=’’ 括起来 , 这一行的其他内容都被忽略掉 . Subst 将分析这个原形 , 寻找替换说明中名字域的所有实例 , 名字实例是用 ’’@<’’ 和 ’’>@’’ 括起来的 , 把它们改变成对应的值 , 然后用这个结果替换目标行 .

选项 (OPTIONS)

-e 替换操作由

sed(1) 编辑器完成 , 它必须放在 /bin 或 /usr/bin

目录下面 . 用 ’’-e’’ 开关可以指定一个不同位置的执行程序 .

示例 (EXAMPLE)

如果 substitutions 文件内容是

FIRST 111

		SECOND
		222 而victim 文件是

x = 2;
/* =()<y = @<FIRST>@ + @<SECOND>@;>()= */
y = 88 + 99;
z = 5; 那么’’subst -f substitutions victim’’ 命令把 victim 改变成 :

x = 2;
/* =()<y = @<FIRST>@ + @<SECOND>@;>()= */
y = 111 + 222;
z = 5;

文件 (FILES)

	victimdir/substtmp.new	建立出来的新版本文件
	victimdir/substtmp.old	经过改名的老版本文件

另见 (SEE ALSO)

诊断 (DIAGNOSTICS)

如果 subst 无法创建临时文件 , 或者临时文件已经存在 , 程序中止并报错 .

历史 (HISTORY)

Henry Spencer 写于 U of Toronto.

Rich $alz 在 1991 年 7 月增加了 ’’-e’’ 选项 .

BUGS

当创建准备用 subst 处理的文件时 , 很容易忘记在原形行后面插入一个要命的目标行 ; 如果你忘了目标行 , subst 最终会删掉原形行下面一行 , 不管那行是什么 .

[中文版维护人 ]

徐明 <xuming [AT] users.net>

[中文版最新更新 ]

2004/02/28

《中国 Linux论坛 man手册页翻译计划》

http://cmpp.linuxforum.net

跋

本页面中文版由中文 man 手册页计划提供。中文 man 手册页计划： https://github.com/man-pages-zh/manpages-zh