SUBST

Section: User Commands (1)
Updated: local
Index Return to Main Contents

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)

sed(1)

诊断 (DIAGNOSTICS)

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

历史 (HISTORY)

Henry Spencer 写于 U of Toronto.

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

BUGS

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

[中文版维护人]

徐明 <xuming@users.sourceforge.net>

[中文版最新更新]

2004/02/28

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

http://cmpp.linuxforum.net

This document was created by man2html, using the manual pages.
Time: 13:12:05 GMT, December 24, 2015