LaTeX3 中的“:D”说明符

LaTeX3 中的“:D”说明符

expl3.pdf3.2.5 中,我注意到说明:D符表示“请勿使用”和“内核团队以外的程序员不应使用这些函数”。但是我还发现这些函数出现在一些用 LaTeX3 编写的包中。

那么有人能告诉我我是否可以使用它们吗?

答案1

:D说明符专门用于原语(所有原语都是 initial \<engine>_<name>:D),并且 none 概念不应出现在核心团队代码之外。(广义上,这意味着在之外,l3kernel但在某些特殊情况下,我们希望:D名称在其他内核级代码中的有限位置使用。)

然而,很明显,该团队还没有覆盖到一些领域expl3或者与 LaTeX2e 的交互需要直接访问原语。对于临时对于目前没有官方接口的模块,团队建议将处理此类情况的代码制定为

\cs_new_eq:NN \__module_name:w \engine_name:D % Probably :w ...

并且后者的名称在这些地方使用:这样,在团队解决这些问题时,只需要调整一行即可。直接在或 LaTeX-L 上向团队提出这些问题也可能是值得的。例如,我最近添加了对和类似的支持,作为此类请求的结果,作为对的\pdffilesize实验性补充。l3file

对于使用 LaTeX2e,我们可能希望代码永远不会“继续前进”,人们通常会坚持使用“经典”名称。

相关内容