[pkgsrc/trunk]: pkgsrc/doc/guide/files Add a section to "Common packages" des...

[brook <brook%pkgsrc.org@localhost>]

details:   https://anonhg.NetBSD.org/pkgsrc/rev/356e2f4ae6b8
branches:  trunk
changeset: 399714:356e2f4ae6b8
user:      brook <brook%pkgsrc.org@localhost>
date:      Wed Aug 14 17:31:34 2019 +0000

description:
Add a section to "Common packages" describing a typical TeXlive package.

diffstat:

 doc/guide/files/creating.xml |  38 +++++++++++++++++++++++++++++++++++++-
 1 files changed, 37 insertions(+), 1 deletions(-)

diffs (52 lines):

diff -r 97c74ae47ffc -r 356e2f4ae6b8 doc/guide/files/creating.xml
--- a/doc/guide/files/creating.xml      Wed Aug 14 17:26:31 2019 +0000
+++ b/doc/guide/files/creating.xml      Wed Aug 14 17:31:34 2019 +0000
@@ -1,4 +1,4 @@
-<!-- $NetBSD: creating.xml,v 1.29 2019/08/14 17:26:31 brook Exp $ -->
+<!-- $NetBSD: creating.xml,v 1.30 2019/08/14 17:31:34 brook Exp $ -->
 
 <chapter id="creating">
 <title>Creating a new pkgsrc package from scratch</title>
@@ -214,6 +214,42 @@
 
 </sect2>
 
+<sect2 id="creating.TeX-package">
+<title>TeXlive packages</title>
+
+<para>TeXlive packages from <ulink
+url="https://www.ctan.org/";>CTAN</ulink> are handled automatically by
+<command>texlive2pkg</command>, which is available in <filename
+role="pkg">pkgtools/texlive2pkg</filename>.</para>
+
+<para>If the TeXlive package name is not known, it may be useful to
+search <ulink url="https://www.ctan.org/";>CTAN</ulink>.  A
+<quote>Contained in</quote> field on the package page typically
+identifies the basename of the package file in the <ulink
+url="https://www.ctan.org/tex-archive/systems/texlive/tlnet/archive";>TeXlive
+archive</ulink>.</para>
+
+<para>If the TeXlive package name is known, download the files from
+the <ulink
+url="https://www.ctan.org/tex-archive/systems/texlive/tlnet/archive";>TeXlive
+archive</ulink>.  For package <filename>foo</filename>, you will need
+to download <filename>foo.tar.xz</filename>.  Most TeXlive packages
+also have associated documentation packages, so download
+<filename>foo.doc.tar.xz</filename> at the same time.  These files
+should be placed in the appropriate category directory, which is often
+but not always <filename>print</filename>.  Then run the following
+command in the category directory.</para>
+
+<programlisting>
+texlive2pkg foo.tar.xz foo.doc.tar.xz
+</programlisting>
+
+<para>This will create two packages, <filename>tex-foo</filename> and
+<filename>tex-foo-doc</filename>.  Be sure to check that both packages
+are correct.</para>
+
+</sect2>
+
 </sect1>
 
 <sect1 id="creating.examples">