☰

Texdoc 和各种文件

tag-icon • tag-icon expl3 documentation
Texdoc 和各种文件

一直在寻找texdoc并发现

texdoc interface3
texdoc source3

其中一份文件称它是一份参考手册，另一份文件称它是一份参考文档，适用于 L3 编程层。这是怎么回事？如果介绍更明确地说明它们的内容以及如何制作或提取信息，那将会很有帮助。

答案1

我没有发现任何混淆或矛盾。文件名有点随意，有历史问题，但这三个文件很自然。

source3 是 expl3 的排版源（就像 source2e 是 latex2e 的文档源，或者 tex-the-program 是文档源 tex.web，即 tex 的源代码）。

interface3 是 expl3 的参考编程手册，摘录自与上面相同的 dtx 文件，但只列出了编程接口和每个可调用命令的描述，而不包括实现源或内部命令。

expl3 并不（尽管您如此断言）声称自己是一本参考手册：它只是对系统的一般介绍。

interface3source3因此是没有实现源排版的子集。这在源代码中是明确的

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% This document typesets the LaTeX3 interface descriptions a single document.
% This produces quite a large file (more than 170 pages currently).
%
% There is also a full version of the sources (source3.tex) which additionally
% also typesets the command implementations.
%

但目前，摘要在两个文件中以相同的方式只是提取出来，因此是相同的文本，我们可以看一下对 interface3 进行修改的摘要，如注释中所述，它是 source3 文档的接口子集。

相关内容