summaryrefslogtreecommitdiff
path: root/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-install-unpack.html
blob: 69ae2b4d7c6efebc2cb1faf96bc202d2678f2c7b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
<head>
<title>UK TeX FAQ -- question label install-unpack</title>
</head><body>
<h3>Unpacking LaTeX packages</h3>
<p/>As discussed <a href="FAQ-dtx.html">elsewhere</a>, the &lsquo;ordinary&rsquo; way to
distribute a LaTeX package is as a pair of files <i>package.dtx</i>
and <i>package.ins</i>.  If you&rsquo;ve acquired such a pair, you simply
process <i>package.ins</i> with LaTeX, and the files will appear,
ready for installation.
<p/>Other sorts of provision should ordinarily be accompanied by a
<i>README</i> file, telling you what to do; we list a few example
configurations.
<p/>Sometimes, a directory comes with a bunch of <i>.dtx</i> files, but
fewer (often only one) <i>.ins</i> files (LaTeX itself comes
looking like this).  The way to go, in this case is simply to process
the <i>.ins</i> file(s) one by one.
<p/>If you&rsquo;re missing the <i>package.ins</i> altogether, you need to play
around until something works.  Some <i>.dtx</i> files are
&ldquo;self-extracting&rdquo; &mdash; they do without a <i>.ins</i> file, and once
you&rsquo;ve processed the <i>package.dtx</i>, <i>package.sty</i> has
automagically appeared.  Various other oddities may appear, but the
archivists aim to have <i>README</i> file in every package, which
should document anything out of the ordinary with the distribution.
<p/><p>This question on the Web: <a href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=install-unpack">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=install-unpack</a>
</body>