l3doc.cls 的文檔

Question

我一直在嘗試將我的套件文件從 轉換ltxdoc為l3doc，但遇到了一些障礙。

首先是開始\ProvidesExplFile工作。我嘗試做這樣的事情：

% \iffalse meta-comment
%<*driver|package>
\GetIdInfo $Id: test.dtx 1.0 2024/02/04 I. M. A. Person <[email protected]> $
     {description of package}
%</driver|package>
%<*driver>
\ProvidesExplFile{\ExplFileName.dtx}
%</driver>
%<package>\NeedsTeXFormat{LaTeX2e}
%<package>\RequirePackage{expl3}
%<package>\ProvidesExplPackage{\ExplFileName}
%<*driver|package>
   {\ExplFileDate}{\ExplFileVersion}{\ExplFileDescription}
%</driver|package>
%<*driver>
\documentclass[12pt]{l3doc}
\begin{document}
  \DocInput{test.dtx}
\end{document}
%</driver>
% \fi
%
% \title{The \pkg{test} package\thanks{This document corresponds to
%   \textsf{test}~\ExplFileVersion, dated \ExplFileDate.}}
% \author{me}
% \date{\ExplFileDate}
% \maketitle
% \begin{documentation}
% \section{Documentation}
% \end{documentation}
% \iffalse
%<*package>
%<@@=test>
% \fi
%
% \begin{implementation}
% \section{Implementation}
% \end{implementation}
%
% \Finale
% \iffalse
%</package>
% \fi
\endinput

但是，這會導致錯誤。如果我使用\ProvidesFile而不是，我就能讓它工作ProvidesExplFile，如下所示：

% \iffalse meta-comment
%<*driver|package>
\GetIdInfo $Id: test.dtx 1.0 2024/01/26 I. M. A. Person <[email protected]> $
     {description of package}
%</driver|package>
%<*driver>
\ProvidesFile{\ExplFileName.dtx}
    [\ExplFileDate\space v\ExplFileVersion\space\ExplFileDescription]
%</driver>
%<package>
%<package>\NeedsTeXFormat{LaTeX2e}
%<package>\RequirePackage{expl3}
%<package>\ProvidesExplPackage{\ExplFileName}
%<package>   {\ExplFileDate}{\ExplFileVersion}{\ExplFileDescription}
%<*driver>
\documentclass[12pt]{l3doc}
\begin{document}
  \DocInput{test.dtx}
\end{document}
%</driver>
% \fi

我究竟做錯了什麼？