Provided by: manpages-zh_1.6.3.3-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 实现。

       本页面中文版由中文 man 手册页计划提供。
       中文 man 手册页计划:https://github.com/man-pages-zh/manpages-zh