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