Provided by: manpages-zh_1.5.2-1_all bug

NAME

       tex, virtex, initex - 文字格式化和排版

SYNOPSIS 總覽
       tex [options] [commands]

DESCRIPTION 描述
       這份手冊頁並不全面。此版本的  TeX  完整的文件可以從  info  檔案或者手冊 Web2C: A TeX implementation
       中找到。

       TeX 格式化指定的檔案中包含著命令的文本,輸出一個設備無關的檔案 (稱為 DVI ,即 “設備無關” DeVice  Independent
       的縮寫)。在       The       TeXbook      中講述了      TeX      的功能和語言。      TeX
       通常與一個大型的預編譯的宏包同時使用,有一些特定的排版系統,例如 LaTeX, 通常需要很多宏包的支持。

       這個版本的  TeX  通過查看它的命令行,查找自身是以什麼名稱被調用的。  initexvirtex  都是到可執行檔案  tex
       的符號鏈接。當作為  initex  調用時  (或者使用了 --ini 選項時),它可以用於將宏預編譯,輸出到一個 .fmt 檔案中。當作為
       virtex 調用時,它將使用 plain 格式。當以任何其他名稱調用時,TeX  將使用那個名稱作為要使用的格式名稱。例如,當作為  tex
       調用時,將使用   tex   格式,這與  plain  格式是相同的。  plain  格式中定義的命令記載在  The  TeXbook
       中。其他常用的格式包括 latexamstex 。

       調用 TeX  時,命令行給出的  commands  被傳遞給它作為輸入的第一行。(但是通常將擴展的參數作為輸入的第一行要簡單許  多,因為
       UNIX  命令解釋器總是會  “吃掉”  或者錯誤地解釋  TeX  的符號,例  如反斜槓,除非你引用它們。) 同 The TeXbook
       書中描述的一致,第一行應當以一個檔名開始,或者是一個控制序列 \controlsequence, 或者是一個格式名稱 &formatname.

       通常的用法是輸入
              tex paper
       來處理  paper.tex  。名稱  paper  將作為任務名  (``jobname''),也用來產生輸出檔名。   如果   TeX
       沒有在第一行獲得一個檔名,jobname   將是   texput  。當查找一個檔案時,TeX  查找帶有和不帶預設擴展名  (.tex)
       的檔案,除非名稱中已包含了此擴展名。如果                                              paper
       是任務名(``jobname''),錯誤消息的日誌記錄,包含著比通常螢幕上顯示的內容更加詳細的內容,將保存為        paper.log
       ,輸出檔案將保存為 paper.dvi 。

       這個版本的  TeX  可以查看檔案  paper.tex  的第一行,看它是否以特殊序列  %&  開始。如果第一行以   %&format
       --translate-file tcxname  開始,那麼  TeX  將使用指定的格式和轉換表 tcxname 來處理源檔案。格式名稱和
       --translate-file 轉換定義都可以被忽略,但是不能同時忽略。這個設定超越了基於可執行檔案名稱的格式選擇。 選項 --parse-
       first-line 或者配置中的變量 parse_first_line 控制了是否允許這樣的行為。

       在     TeX    的錯誤提示下回應    e    將使得系統預設的編輯器被啟動,修改當前檔案的當前行。環境變量    TEXEDIT
       可以用來修改所用的編輯器。它可以包含一個字符串   "%s",指定檔名要替換的位置,以及字符串    "%d",指定行號    (如果有的話)
       要替換的位置。例如,要使用 emacs ,可以這樣設置 TEXEDIT 字符串,使用 sh 命令
              TEXEDIT="emacs +%d %s"; export TEXEDIT

       為了方便,庫中有一個檔案              null.tex              ,內容為空。當             TeX
       找不到可能的輸入時,它會一直讓使用者輸入另一個檔名;如果不想輸入任何東西,回應 `null'  可以跳出這個循環。也可以輸入  EOF  字符
       (通常是 control-D)。

OPTIONS 選項
       這個版本的 TeX 可以解釋下列命令行選項。

       --file-line-error-style
              列印錯誤消息,以 file:line:error 的形式,與大多數編譯器格式化消息的方式相似。

       --fmt format
              使用 format 作為要使用的格式名,而不是調用 TeX 的名稱或者 %& 一行指定的內容。

       --help
              列印幫助信息,然後退出。

       --ini
              成為 initex ,用於轉儲格式 (dump formats);如果調用的程式名是 initex ,那麼隱含這個選項。

       --interaction mode
              設置交互模式。mode    可以是   batchmode,   nonstopmode,   scrollmode,   和
              errorstopmode 其中之一。這些模式的含義與相應的 \commands 相同。

       --ipc
              將 DVI 輸出發送到一個 socket,同時像通常那樣輸出到檔案。這個選項是否可用取決於安裝程式的選擇。

       --ipc-start--ipc 類似,並且同時也在另一段啟動伺服器。這個選項是否可用取決於安裝程式的選擇。

       --jobname name
              使用 name 作為作業名,而不是從輸入檔名獲得。

       --kpathsea-debug bitmask
              根據位掩碼,設置路徑搜索調試標誌。細節請參見 Kpathsea 手冊頁。

       --maketex fmt
              啟用 mktexfmt ,這裏 fmt 必須是 tex 或者 tfm 之一。

       --mltex
              啟用 MLTeX 擴展。

       --no-maketex fmt
              禁用 mktexfmt 這裏 fmt 必須是 tex 或者 tfm 之一。

       --output-comment string
              使用 string 作為 DVI 檔案的注釋,而不是時間。

       --parse-first-line
              如果主輸入檔案的第一行以 %& 開始,就解釋它,從中查找一個轉儲名稱或者一個 --translate-file 選項。

       --progname name
              偽裝是程式 name 。這對所用格式和搜索路徑都有影響。

       --recorder
              啟用檔名記錄。這將在一個擴展名為 .fls 的檔案中記錄輸入和輸出中打開的所有檔案。

       --shell-escape
              啟用   \write18{command}   結構。   command   可以是任何   Bourne    shell
              命令。出於安全原因,這個結構通常被禁止。

       --translate-file tcxname
              使用 tcxname 轉換表。

       --version
              顯示版本信息,然後退出。

ENVIRONMENT 環境
       參見  Kpathsearch  庫的文件  (手冊頁的 `Path specifications' 節點) 來查看使用環境變量的精確的細節。
       kpsewhich 實用工具可以用來查詢變量的值。

       警告:在大多數     TeX     格式中,不能直接傳給     TeX     帶有      ~      的檔名,因為      ~
       是一個有特殊意義的字符,它將被擴展,不會作為檔名的一部分。其他程式,例如 Metafont,沒有這個問題。

       TEXMFOUTPUT
              通常,TeX      將輸出檔案放在當前目錄。如果不能在那裏創建任何輸出檔案,它試著在環境變量     TEXMFOUTPUT
              指定的目錄中創建它。這個參數沒有預設值。例如,假設命令是 tex paper 並且當前目錄不可寫,如果  TEXMFOUTPUT
              設置為   /tmp   ,TeX   試圖創建   /tmp/paper.log   (還有   /tmp/paper.dvi
              ,如果產生了任何輸出。)

       TEXINPUTS
              \input\openin        檔案的搜索路徑。它們一般應當以        ``.''
              開始,使得使用者檔案可以先於系統檔案被找到。空路徑成分將被替換為     texmf.cnf    檔案中定義的路徑。例如,設置
              TEXINPUTS  為   ".:/home/usr/tex:"   來將當前目錄和   ``/home/user/tex''
              添加到標準的搜索路徑之前。

       TEXEDIT
              切換為編輯器的命令模板。預設值通常是 vi ,在 TeX 編譯時進行設置。

FILES 檔案
       下面提到的檔案的位置在各個系統中是不相同的。使用 kpsewhich 實用工具來找到它們的位置。

       texmf.cnf
              配置檔案。它包含著搜索路徑的定義,還有其他配置參數,例如 parse_first_line.

       tex.pool
              編碼的文本,是 TeX 的提示消息。

       texfonts.map
              檔名映射定義。

       *.tfm  TeX 字型的度量的檔案。

       *.fmt  簡寫的 TeX 格式 (.fmt) 檔案。

       $TEXMFMAIN/tex/plain/base/plain.tex
              基本的宏包,在 TeXbook 中有詳細描述。

BUGS

       這個版本的    TeX   實現了大量的可選的擴展。實際上,其中大部分與   TeX   的定義有或多或少的沖突。當啟用這樣的擴展時,TeX
       啟動時列印的提示信息將是 TeXk 而不是 TeX 。

       這個版本的 TeX 在面積增加或減少時不能捕獲算術下溢錯誤。這種情況很少見,但是一旦出現,產生的 DVI 檔案將是無效的。

SEE ALSO 參見
       mf(1),
       Donald E. Knuth, The TeXbook, Addison-Wesley, 1986, ISBN 0-201-13447-0.
       Leslie Lamport, LaTeX - A Document Preparation System,  Addison-Wesley,
       1985, ISBN 0-201-15790-X.
       K.        Berry,        Eplain:        Expanded        plain       TeX,
       ftp://ftp.cs.umb.edu/pub/tex/eplain/doc.
       Michael Spivak, The Joy of TeX, 2nd edition, Addison-Wesley, 1990, ISBN
       0-8218-2997-1.
       TUGboat (the journal of the TeX Users Group).

TRIVIA 提醒
       TeX,如果發音正確的話,與   ``blecchhh''   押韻  (rhymes)。使用  typewriter  字型時,正確的拼寫是
       ``TeX'' 而不是 ``TEX'' 或者 ``tex''。

AUTHORS 作者
       TeX 的設計者是 by Donald E. Knuth,他用他的 Web 系統實現了它。後來,它分別被 Stanford 的  Howard
       Tricky 和 Cornell 的 Pavel Curtis 移植到了 Unix。當前隨 Unix TeX 發行的這個版本使用了 Web 到
       C 的翻譯系統 (web2c) 來產生, (web2c) 最初由 Tomas Rokicki 和 Tim Morgan 實現。