[twg-tds] scripts, enc/lig/map

Karl Berry karl at freefriends.org
Mon Mar 1 03:02:04 CET 2004


I've been pondering the assorted messages sent over the last 10 days or
so, and here is a revised version of the description of the proposed
scripts directory for the TDS.  I may move it to a separate section
before release, but for now the content is of course the important thing.

Thomas, have I accurately described the purpose and usage?

Paul, is the rationale clear?  (As for rationale in general,
that's what the "Is there a better way?" appendix is all about.)

Thanks,
k


\item[\path|scripts|]
for platform-independent executables such as Perl, Python, and shell
scripts, and Java class files.  Subdirectories under \path|scripts| are
package names.  

The intent is not for all such directories to be added to a user's
command search path, which would be quite impractical.  Rather, these
executables are for the benefit of wrapper scripts in whatever
executable directory a distribution may provide (which is not specified
by the \abbr{TDS}).  This eases creating distributions, by providing a
common place for such platform-independent programs.

We recommend using extensions specifying the language (such as
\path|.pl|, \path|.py|, \path|.sh|) on these files, to help uniquely
identify the name.  Since the programs in \path|scripts| are not
intended for users to invoke directly, this poses no inconvenience.

For example, in the \TeX\ Live distribution, the Con\TeX{}t user-level
program \path|texexec| can exist as a small wrapper script in each
\path|bin/|\replaceable{platform}\path|/texexec| (which is outside the
\path|texmf| tree), which merely calls
\path|texmf/scripts/context/perl/texexec.pl|.

Examples:
\begin{ttdisplay}
scripts/context/perl/texexec.pl
scripts/context/ruby/examplex.rb
scripts/thumbpdf/thumbpdf.pl
\end{ttdisplay}



More information about the twg-tds mailing list