summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-install-unpack.html
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-install-unpack.html')
-rw-r--r--Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-install-unpack.html26
1 files changed, 26 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-install-unpack.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-install-unpack.html
new file mode 100644
index 00000000000..600d4b8d617
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-install-unpack.html
@@ -0,0 +1,26 @@
+<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 <code>.dtx</code> files, but
+fewer (often only one) <code>.ins</code> files (LaTeX itself comes
+looking like this). If there is more than one <code>.ins</code> file,
+and in the absence of any instruction in the <i>README</i> file, simply
+process the <code>.ins</code> 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 <code>.dtx</code> files are
+&ldquo;self-extracting&rdquo; &mdash; they do without an <code>.ins</code> 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>