NAME¶
groff - groff 文件排版系統前端
總覽 (SYNOPSIS)¶
groff [
-abehilpstvzCENRSUVXZ ] [
-wname ] [
-Wname ] [
-mname ] [
-Fdir ] [
-Idir ] [
-Tdev ] [
-ffam ] [
-Mdir ] [
-dcs ] [
-rcn ] [
-nnum ] [
-olist ] [
-Parg ] [
-Larg ] [
files... ]
描述 (DESCRIPTION)¶
groff 是 groff
文件排版系統的前端。
一般來說, 它運行
troff
程式和一個同選擇的設備相對應的後處理器。
可選的設備有
- ps
- PostScript
列表機和查看器。
- dvi
- TeX dvi 格式。
- X75
- 一個 75
點每英寸的 X11
查看器。
- X100
- 一個 100
點每英寸的 X11
查看器。
- ascii
- 打字機一類的設備。
- latin1
- 用 ISO Latin-1
字符集的打字機設備。
- lj4
- 一個相容 HP LaserJet4
的(或者其它相容 PCL5 的)
列表機。
- html
- 輸出 HTML 格式。
在設備描述檔案裏,
設備的後處理器是通過
postpro 命令指定的。
這個可以被
-X
選項改寫。
預設的設備是
ps。
它可以選擇用
pic,
eqn,
tbl,
refer, 或者
soelim
等預處理器。
如果沒有任何選項,
可以用一個單獨的
-
來代替。 檔名
-
代表標準輸入。
grog
命令可以根據檔案格式猜測相應的
groff 命令。
選項 (OPTIONS)¶
- -h
- 列印幫助信息。
- -e
- 用 eqn 預處理。
- -t
- 用 tbl 預處理。
- -p
- 用 pic 預處理。
- -s
- 用 soelim 預處理。
- -Idir
- 此選項在 soelim(1)
中描述。 此選項包含
-s 選項。
- -R
- 用 refer 預處理。
沒有傳輸參數給 refer
的機制, 因為很多 refer
選項在檔案裏有相應的命令。
細節請參照
refer(1)。
- -v
- 使 groff
運行的程式列印出版本號。
- -V
- 在標準輸出列印管道線,
而不執行它。
- -z
- 禁止 troff 輸出。
只有出錯信息顯示出來。
- -Z
- 不後處理 troff
的輸出。 一般 groff
會自動運行相應的後處理器。
- -Parg
- 把 arg
傳給後處理器。
每個參數都要用單獨的
-P 選項分開。 注意
groff 在傳 arg
給後處理器時不會在前加上
- 。
- -l
- 把輸出送到列表機,
所用的命令在設備描述檔案中用
print 命令分開。
- -Larg
- 把 arg
傳給列表機。
每個參數都要用單獨的
-L 選項分開。 注意
groff 在傳 arg
給後處理器時不會在前加上
- 。
- -Tdev
- 生成針對 dev
設備的輸出。
預設的設備是 ps。
- -X
- 用 gxditview 預覽,
而不是用一般的後處理器。
Groff 會傳給 gxditview 一個
-printCommand 選項,
這樣如果有 -l 選項
Print 就會做 groff
會做的事。 除非有
-Tps 選項,
否則這並不能產生好的輸出。
- -N
- 在 eqn
分割符出不產生新行符(newline)。
這個同 eqn 中的 -N
選項有一樣的作用。
- -S
- 安全模式。 把 -S
選項傳給 pic 並且對
troff 用 -msafer 宏。
(預設開啟)
- -U
- 不安全模式。
用以前的不安全的特性。
- -a
-
- -b
-
- -i
-
- -C
-
- -E
-
- -wname
-
- -Wname
-
- -mname
-
- -olist
-
- -dcs
-
- -rcn
-
- -Fdir
-
- -Mdir
-
- -ffam
-
- -nnum
- 這些都在 troff(1)
中描述。
環境 (ENVIRONMENT)¶
- GROFF_COMMAND_PREFIX
- 如果這個變量設為
X, groff 會運行
Xtroff, 而不是
troff。 這也適用於
tbl, pic, eqn,
refer, 和
soelim。但並不適用於
grops, grodvi, grotty,
grolj4, grohtml, 和
gxditview。
- GROFF_TMAC_PATH
- 一個冒號分開的列表,
包含尋找宏檔案的路徑。
- GROFF_TYPESETTER
- 預設設備。
- GROFF_FONT_PATH
- 一個冒號分開的列表,
包含尋找 devname
的路徑。
- PATH
- groff
執行命令的搜尋路徑。
- GROFF_TMPDIR
- 臨時檔案目錄。
如果沒有設置此變量但是設置了
TMPDIR
臨時檔案就會在那個目錄中創建。
否則臨時檔案就會在
/tmp 中創建。 grops(1) 和
refer(1)
命令都會創建臨時檔案。
檔案 (FILES)¶
- /usr/lib/groff/font/devname/DESC
- name
設備的設備描述檔案。
- /usr/lib/groff/font/devname/F
- name 設備的 F
字型的字型檔案。
作者 (AUTHOR)¶
James Clark <jjc@jclark.com>
錯誤 (BUGS)¶
報錯誤報告給 bug-groff@gnu.org。
請包含一個完整的報告,
還有一個能使錯誤再次出現的例子,
並注明用的是 groff
的哪個版本。
版權 (COPYRIGHT)¶
版權所有 © 1989, 1990, 1991, 1992, 1999
自由軟體基金會
這一程式是自由軟體,
你可以遵照自由軟體基金會出版的
GNU 通用公共許可
証條款來修改和重新發佈這一程式。
或者用許可証的第二版,
或者(根據你的選
擇)用任何更新的版本。
發佈 groff
程式的目的是希望它有用,
但沒有任何擔保。
甚至沒有適合特定目
的的隱含的擔保。
更詳細的情況請參閱 GNU
通用公共許可証。
你應該已經和程式一起收到一份
GNU
通用公共許可証的副本。
如果還沒有,
寫信給: The Free Software Foundation, Inc., 675 Mass
Ave, Cambridge, MA02139, USA
獲取 (AVAILABILITY)¶
groff
的最新版本可以通過匿名
ftp 從 ftp.gnu.org/gnu/groff 得到。
參見 (SEE ALSO)¶
grog(1),
troff(1),
tbl(1),
pic(1),
eqn(1),
soelim(1), refer(1),
grops(1),
grodvi(1),
grotty(1),
grohtml(1),
gxditview(1),
groff_font(5),
groff_out(5),
groff_man(7),
groff_ms(7),
groff_me(7),
groff_char(7),
groff_msafer(7)
[中文版維護人]¶
唐友 <tony_ty@263.net>
[中文版最新更新]¶
2001/8/29
[中國Linux論壇man手冊頁翻譯計劃]¶
http://cmpp.linuxforum.net