DocStrip 不喜欢词汇表吗？

Question

我调整了你的源代码，使之真正成为现实Example.dtx，因为在标准 TeX 分布中Example.ins已经有一个。example.sty

Example.dtx：

% \iffalse meta-comment
%
% Copyright (C) XXXX by Carel <[email protected]>
% ----------------------------------------
%
% This file may be distributed and/or modified under the
% conditions of the LaTeX Project Public License, either version 1.2
% of this license or (at your option) any later version.
% The latest version of this license is in:
%
%    http://www.latex-project.org/lppl.txt
%
% and version 1.2 or later is part of all distributions of LaTeX
% version 1999/12/01 or later.
%
% \fi
%
% \iffalse
%<*driver>
\ProvidesFile{Example.dtx}
%</driver>
%<package>\NeedsTeXFormat{LaTeX2e}[1999/12/01]
%<package>\ProvidesPackage{Example}
%<*package>
   [2004/11/05 v1.0 .dtx Example file]
%</package>
%
%<*driver>
\documentclass{ltxdoc}
\usepackage[nomain]{glossaries}
\usepackage{Example}[2004/11/05]
\EnableCrossrefs
\CodelineIndex
\RecordChanges
\makeglossaries
\begin{document}
 \DocInput{Example.dtx}
 \PrintChanges
 \PrintIndex
\end{document}
%</driver>
% \fi
%
% \CheckSum{0}
%
% \CharacterTable
%  {Upper-case    \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
%   Lower-case    \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
%   Digits        \0\1\2\3\4\5\6\7\8\9
%   Exclamation   \!     Double quote  \"     Hash (number) \#
%   Dollar        \$     Percent       \%     Ampersand     \&
%   Acute accent  \'     Left paren    \(     Right paren   \)
%   Asterisk      \*     Plus          \+     Comma         \,
%   Minus         \-     Point         \.     Solidus       \/
%   Colon         \:     Semicolon     \;     Less than     \<
%   Equals        \=     Greater than  \>     Question mark \?
%   Commercial at \@     Left bracket  \[     Backslash     \\
%   Right bracket \]     Circumflex    \^     Underscore    \_
%   Grave accent  \`     Left brace    \{     Vertical bar  \|
%   Right brace   \}     Tilde         \~}
%
%
% \changes{v1.0}{2004/11/05}{Initial version}
%
% \GetFileInfo{Example.dtx}
%
% \DoNotIndex{\newcommand,\newenvironment}
%
%
% \title{The \textsf{Example} package\thanks{This document
%   corresponds to \textsf{Example}~\fileversion, dated \filedate.}}
% \author{Carel \\ \texttt{[email protected]}}
%
% \maketitle
%
% \section{Introduction}
%
% Put text here.
%
% \section{Usage}
%
% Put text here.
%
% \DescribeEnv{notes}
%
% Notes is an example glossary type. It has a single \gls{entry} in it.
%
% \StopEventually{}
%
% \section{Implementation}
%
% \begin{environment}{notes}
% I define an example glossary environment called |notes|.
%    \begin{macrocode}
\newglossary[egg]{example}{egd}{egn}{Example glossary}
%    \end{macrocode}
% \end{environment}
%
% \begin{macro}{notes}
% I define a single entry in the new glossary format
%    \begin{macrocode}
\newglossaryentry{entry}{
name        = entry,
type        = example,
description = An example entry in notes,
}
%    \end{macrocode}
% \end{macro}
%
% \printglossaries% added for testing purposes - just to be sure
%
% \Finale
\endinput

Example.ins：

%%
%% Copyright (C) XXXX by carel <[email protected]>
%%
%% This file may be distributed and/or modified under the conditions of
%% the LaTeX Project Public License, either version 1.2 of this license
%% or (at your option) any later version.  The latest version of this
%% license is in:
%%
%%    http://www.latex-project.org/lppl.txt
%%
%% and version 1.2 or later is part of all distributions of LaTeX version
%% 1999/12/01 or later.
%%

\input docstrip.tex
\keepsilent

\usedir{tex/latex/example}

\preamble

This is a generated file.

Copyright (C) XXXX by carel <[email protected]>

This file may be distributed and/or modified under the conditions of
the LaTeX Project Public License, either version 1.2 of this license
or (at your option) any later version.  The latest version of this
license is in:

  http://www.latex-project.org/lppl.txt

and version 1.2 or later is part of all distributions of LaTeX version
1999/12/01 or later.

\endpreamble

\generate{\file{Example.sty}{\from{Example.dtx}{package}}}

\obeyspaces
\Msg{*************************************************************}
\Msg{*                                                           *}
\Msg{* To finish the installation you have to move the following *}
\Msg{* file into a directory searched by TeX:                    *}
\Msg{*                                                           *}
\Msg{*     Example.sty                                           *}
\Msg{*                                                           *}
\Msg{* To produce the documentation run the file Example.dtx     *}
\Msg{* through LaTeX.                                            *}
\Msg{*                                                           *}
\Msg{* Happy TeXing!                                             *}
\Msg{*                                                           *}
\Msg{*************************************************************}

\endbatchfile

得出的结果如下Example.sty：

%%
%% This is file `Example.sty',
%% generated with the docstrip utility.
%%
%% The original source files were:
%%
%% Example.dtx  (with options: `package')
%% 
%% This is a generated file.
%% 
%% Copyright (C) XXXX by carel <[email protected]>
%% 
%% This file may be distributed and/or modified under the conditions of
%% the LaTeX Project Public License, either version 1.2 of this license
%% or (at your option) any later version.  The latest version of this
%% license is in:
%% 
%%   http://www.latex-project.org/lppl.txt
%% 
%% and version 1.2 or later is part of all distributions of LaTeX version
%% 1999/12/01 or later.
%% 
\NeedsTeXFormat{LaTeX2e}[1999/12/01]
\ProvidesPackage{Example}
   [2004/11/05 v1.0 .dtx Example file]
\newglossary[egg]{example}{egd}{egn}{Example glossary}
\newglossaryentry{entry}{
name        = entry,
type        = example,
description = An example entry in notes,
}
\endinput
%%
%% End of file `Example.sty'.

以及以下文档：

如果您使用不区分大小写的文件系统，则应使用其他名称，否则可能会以不可预测的方式Example混淆。example

所以一切似乎都有效。话虽如此，我并不完全确定你为什么要这样做。也就是说，据我所知，当你只想创建一个词汇表时，为什么要这么麻烦呢.dtx？.ins该glossaries软件包已经允许您以简单的格式保存词汇表条目的数据库.tex。我按主题列出了一大堆，然后可以只加载我需要的条目。如果我添加新条目或更改它们，它们会立即可用 - 无需费力重新生成.sty文件。

.dtx/ stuff.ins旨在帮助分发软件包，但即使您正在分发主题词汇表，那么一个简单的.tex词汇表文件存档不是更简单吗？

Answer 1