'\" t .ig troff.man Last update : 9 Jan 2002 This file is part of groff, the GNU roff type-setting system. Copyright (C) 1989, 2000, 2001, 2002 Free Software Foundation, Inc. written by James Clark modified by Werner Lemberg Bernd Warken Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with the Invariant Sections being this .ig-section and AUTHOR, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the Free Documentation License is included as a file called FDL in the main directory of the groff source package. .. . . .\" -------------------------------------------------------------------- .\" Setup .\" -------------------------------------------------------------------- . .mso www.tmac . .if n \{\ . mso tty-char.tmac . ftr CR R . ftr CI I . ftr CB B .\} . .if '\*[.T]'dvi' \ . ftr CB CW . .de TQ .br .ns .TP \\$1 .. . .\" Like TP, but if specified indent is more than half .\" the current line-length - indent, use the default indent. .de Tp .ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP .el .TP "\\$1" .. . . .\" -------------------------------------------------------------------- .\" Title .\" -------------------------------------------------------------------- . .TH TROFF 1 "16 September 2002" "Groff Version 1.18.1" .SH NAME troff \- groff 文檔排版系統的 troff 處理器 . . .\" -------------------------------------------------------------------- .SH "總覽 SYNOPSIS" .\" -------------------------------------------------------------------- . .nr a \n(.j .ad l .nr i \n(.i .in +\w'\fBtroff 'u .ti \niu .B troff .de OP .ie \\n(.$-1 .RI "[\ \fB\\$1\fP" "\\$2" "\ ]" .el .RB "[\ " "\\$1" "\ ]" .. .OP \-abcivzCERU .OP \-d cs .OP \-f fam .OP \-F dir .OP \-m name .OP \-M dir .OP \-n num .OP \-o list .OP \-r cn .OP \-T name .OP \-w name .OP \-W name .RI "[\ " files\|.\|.\|. "\ ]" .br .ad \na .P 在一個命令行選項與其參數之間可以有空格。 . . .\" -------------------------------------------------------------------- .SH "描述 DESCRIPTION" .\" -------------------------------------------------------------------- . 這份手冊頁描述了 GNU 版本的 .BR troff . 它是 groff 文檔排版系統的一部分。 . 它與 UNIX troff 的功能兼容，但是有很多的擴展，參見 .BR \%groff_diff (7). 通常它應當用 .BR groff (1) 命令調用，groff 會以合適的順序和合適的選項，運行預處理器和後處理器。 . . .\" -------------------------------------------------------------------- .SH "選項 OPTIONS" .\" -------------------------------------------------------------------- . .TP \w'\-dname=s'u+2n .B \-a 產生一個排版輸出的 .SM ASCII 近似結果 (approximation) . .TP .B \-b 在每條錯誤或警告消息中打印回溯信息 . 此信息可以幫助跟蹤錯誤的原因 . 信息中的行號可能有誤，因爲 .BR troff 中行號的意義與請求類型是 .B as 還是 .B am 有關 . .TP .B \-c 禁止顏色輸出 (兼容模式下總是禁止) . .TP .B \-C 使用兼容模式 . .TP .BI \-d cs .TQ .BI \-d name = s 定義 .I c 或 .I name 是一個字符串 .IR s ; .I c 必須是單字符的一個名稱 . .TP .B \-E 阻止 .BR troff 的錯誤輸出. 注意這不影響發出 .B tm 或 .B tm1 請求的宏包發出的錯誤消息向標準錯誤輸出 . .TP .BI \-f fam 使用 .I fam 作爲默認字體族 . .TP .BI \-F dir 在目錄中 (或目錄路徑中) 搜索 .I dir 子目錄 .BI dev name .RI ( name 是設備的名稱) 查找其中的 .B DESC 文件和字體文件 .I dir 在所有其他字體目錄之前查找 . .TP .B \-i 處理完所有輸入文件後繼續從標準輸入讀入 . .TP .BI \-m name 讀入文件 .IB name .tmac\fR. 如果沒有找到，則去讀 .BI tmac. name . 它將先在 .B \-M 命令行參數給定的目錄中搜索，然後是 .B GROFF_TMAC_PATH 環境變量中的目錄，然後是當前目錄 (安全模式不會做這一步)， 然後是個人目錄，/usr/lib/groff/site-tmac, /usr/share/groff/site-tmac 還有 /usr/share/groff/1.18.1/tmac. . .TP .BI \-M dir 搜索目錄 (或目錄路徑) .I dir 查找宏文件 . 檢索在所有其他宏目錄之前進行 . .TP .BI \-n num 爲第一頁編號 .IR num . . .TP .BI \-o list 僅輸出 .IR list 中指定的頁，參數是一個以逗號分隔的頁號範圍的列表; .I n 意思是打印頁面 .IR n , .IB m \- n 意思是打印 .I m 到 .IR n 之間的所有頁面, .BI \- n 意思是打印直到 .IR n 的所有頁面, .IB n \- 意思是打印從 .IR n 開始的所有頁面，直到結束. .B troff 打印完列表中的最後一頁後將退出 . .TP .BI \-r cn .TQ .BI \-r name = n 設置數字寄存器 .I c 或 .I name 爲 .IR n ; .I c 必須是單字符的一個名稱， .I n 可以是任何 troff 數字表達式 . .TP .B \-R 不讀取 .B troffrc 和 .BR troffrc-end . . .TP .BI \-T name 爲設備 .IR name 而不是默認的 .BR ps 準備輸出 . .TP .B \-U 不全模式 . 這將允許下列請求 .BR open , .BR opena , .BR pso , .BR sy , 和 .BR pi . 出於安全原因，這些潛在的危險的請求在其他情況下被禁止。 . 同時它將當前目錄加入宏搜索路徑 . .TP .B \-v 打印版本號 . .TP .BI \-w name 允許發出 .IR name 警告。可能的警告名稱在下面的 .I "警告 WARNINGS" 章節中詳述 . 例如，要允許所有警告，使用 .B \-w .BR all . 允許使用多個 .B \-w 選項 . .TP .BI \-W name 禁止發出 .IR name 警告。允許使用多個 .B \-W 選項 . .TP .B \-z 阻止格式化的輸出 . . .\" -------------------------------------------------------------------- .SH "警告 WARNINGS" .\" -------------------------------------------------------------------- . .B troff 可以發出的警告分爲下列類別 . 每種警告關聯的名稱在 .B \-w 和 .B \-W 選項中使用；關聯的數字被 .B warn 請求和 .B .warn 寄存器使用, 它總是 2 的冪，以允許位運算 . .P .TS tab(@), center, box; c c c | c c c r rI lB | r rI lB. Bit@Code@Warning@Bit@Code@Warning _ 0@1@char@10@1024@reg 1@2@number@11@2048@tab 2@4@break@12@4096@right-brace 3@8@delim@13@8192@missing 4@16@el@14@16384@input 5@32@scale@15@32768@escape 6@64@range@16@65536@space 7@128@syntax@17@131072@font 8@256@di@18@262144@ig 9@512@mac@19@524288@color .TE . .P .nr x \w'\fBright-brace'+1n+\w'00000'u .ta \nxuR . .TP \nxu+3n .BR break "\t4" 在填充 (fill) 模式下，不可分行的行的長度 比行的長度要小。 In fill mode, lines which could not be broken so that their length was less than the line length. . 此警告是默認允許的 . .TP .BR char "\t1" 不存在的字符。 . 此警告是默認允許的 . .TP .BR color "\t524288" 顏色相關的警告 . .TP .BR delim "\t8" 關閉定界符丟失或不匹配 . .TP .BR di "\t256" 沒有當前轉移 (current diversion) 而使用了不帶參數的 .B di 或 .B da . .TP .BR el "\t16" 使用 .B el 請求但是沒有相應的 .B ie 請求 . .TP .BR escape "\t32768" 不可識別的轉義序列。 . 當遇到一個不可識別的轉義序列時，轉義字符被忽略 . .TP .BR font "\t131072" 不存在的字體。 . 此警告是默認允許的 . .TP .BR ig "\t262144" .B ig 請求忽略的文本中的非法轉義。 . 如果不是在被忽略的文本中，它們將是錯誤 . .TP .BR input "\t16384" 非法輸入字符 . .TP .BR mac "\t512" 使用未定義的字符串，宏和標號 (diversions) (?). . 當使用一個未定義的字符串，宏或標號 (diversions) 時，字符串被自動定義爲空。 . 因此，在大多數情況下，每個名字最多會給出一個警告 . .TP .BR missing "\t8192" 請求缺少必要的參數 . .TP .BR number "\t2" 非法數值表達式。 . 此警告是默認允許的 . .TP .BR range "\t64" 超出範圍的參數 . .TP .BR reg "\t1024" 使用未定義的數字寄存器。 . 當使用一個未定義的數字寄存器時，寄存器被自動定義爲值 \~0。 . 因此，大多數情況下，使用一個特定的名字最多會得到一個警告 . .TP .BR right-brace "\t4096" 在應當使用數字的地方使用了 .B \[rs]} . .TP .BR scale "\t32" 無意義的比例指示 (scaling indicators). . .TP .BR space "\t65536" 在一個請求或宏與其參數之間缺少空格。 . 當遇到一個兩個字符以上的未定義名字，並且名字的前兩個字符是一個已定義的名稱時將給出這個警告， . 請求或宏不會執行。 . 當給出這個警告時，不會自動定義宏。 . 此警告是默認允許的。 . 在兼容模式下不會發生這種警告 . .TP .BR syntax "\t128" 數值表達式中語法有歧義 . .TP .BR tab "\t2048" 不合適地使用了 tab 字符。 在應當使用數字的地方使用了tab字符，或者在一個未用雙引號引用的宏參數中使用tab 時會發生 . .P 也有可以引用一組警告的名稱 . .TP .B all 所有的警告，除了 .BR di , .BR mac , 和 .BR reg . 它的目的是指代所有在傳統的宏包中有用的警告 . .TP .B w 所有警告 . . .\" -------------------------------------------------------------------- .SH "環境 ENVIRONMENT" .\" -------------------------------------------------------------------- . .TP .SM .B GROFF_TMAC_PATH 一個以冒號分隔的目錄的列表，從中搜索宏文件 .B troff 將先搜索 .B \-M 選項給出的目錄，以及標準的路徑 ( 當前目錄 (如果是不安全模式)，個人目錄 .BR /usr/lib/groff/site-tmac , .BR /usr/share/groff/site-tmac , .BR /usr/share/groff/1.18.1/tmac ) 最後搜索它 . .TP .SM .B GROFF_TYPESETTER 默認設備 . .TP .SM .B GROFF_FONT_PATH 一個以冒號分隔的目錄的列表，從中搜索 .BI dev name 目錄。 .B troff 將先搜索 .B \-F 選項給出的目錄，以及標準的路徑 .RB ( /usr/share/groff/site-font , .BR /usr/share/groff/1.18.1/font , .BR /usr/lib/font ) 最後搜索它 . . .\" -------------------------------------------------------------------- .SH "文件 FILES" .\" -------------------------------------------------------------------- . .Tp \w'/usr/share/groff/1.18.1/font/devname/DESC'u+3n .B /usr/share/groff/1.18.1/tmac/troffrc 初始化文件 (在任何其他宏包之前調用). . .TP .B /usr/share/groff/1.18.1/tmac/troffrc-end 初始化文件 (在任何其他宏包之後調用). . .TP .BI /usr/share/groff/1.18.1/tmac/ name .tmac .TQ .BI /usr/share/groff/1.18.1/tmac/tmac. name 宏文件 . .TP .BI /usr/share/groff/1.18.1/font/dev name /DESC 設備 .IR name 的設備描述文件. . .TP .BI /usr/share/groff/1.18.1/font/dev name / F 設備 .IR name 的字體 .I F 的字體文件 .P 注意默認情況下既不在當前目錄也不在個人目錄搜索 .B troffrc 和 .B troffrc-end ，因爲安全的原因 (即使給出了 .B \-U 選項)。 . 如果有必要，使用 .B \-M 命令行選項或者 .B GROFF_TMAC_PATH 環境變量來將這些路徑添加到搜索路徑中 . . .\" -------------------------------------------------------------------- .SH "作者 AUTHOR" .\" -------------------------------------------------------------------- . Copyright (C) 1989, 2001, 2002 Free Software Foundation, Inc. . .P 此文檔按照 FDL (GNU Free Documentation License) 1.1 或更新版本的要求發佈。 . You should have received a copy of the FDL on your system, it is also available on-line at the .URL http://www.gnu.org/copyleft/fdl.html "GNU copyleft site" . This document was written by James Clark, with modifications from .MTO wl@gnu.org "Werner Lemberg" 和 .MTO bwarken@mayn.de "Bernd Warken" . .P 此文檔是 .IR groff GNU roff 套件的一部分 . . .\" -------------------------------------------------------------------- .SH "參見 SEE ALSO" .\" -------------------------------------------------------------------- . .TP .BR groff (1) .I groff 系統的主程序， .IR troff 的包裝. . .TP .BR groff (7) .I groff 語言的描述，包括一個雖然短但是完整的手冊，內容是所有預定義的 請求 (request)，寄存器 (register) 和 .IR groff 正文的轉義 (escapes of plain groff). 可以在命令行查看，使用命令 .RS .IP .B man 7 groff .RE . .TP .BR \%groff_diff (7) .I groff 語言和傳統的 .I classical troff 語言不同之處。 . 當前，這是 .I groff 系統最爲現實 (actual) 的一篇文檔 . .TP .BR roff (7) 對 .I groff 和其他 .I roff 系統的概述，包括更多相關文檔的鏈接 . .P .I groff info .IR file , 參見 (cf.\&) .BR info (1), 將所有 groff 文檔整合到了單獨的一篇文檔中 . . .\" -------------------------------------------------------------------- .\" Emacs variables .\" -------------------------------------------------------------------- . .\" Local Variables: .\" mode: nroff .\" End: .SH "[中文版維護人]" .B bbbush .SH "[中文版最新更新]" .B 2003.11.25 .SH "《中國linux論壇man手冊翻譯計劃》:" .BI http://cmpp.linuxforum.net .SH "跋" .br 本頁面中文版由中文 man 手冊頁計劃提供。 .br 中文 man 手冊頁計劃：\fBhttps://github.com/man-pages-zh/manpages-zh\fR