CVS commit: pkgsrc/doc/guide/files

["Brook Milligan" <brook%netbsd.org@localhost>]

Module Name:    pkgsrc
Committed By:   brook
Date:           Wed Aug 14 17:31:34 UTC 2019

Modified Files:
        pkgsrc/doc/guide/files: creating.xml

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


To generate a diff of this commit:
cvs rdiff -u -r1.29 -r1.30 pkgsrc/doc/guide/files/creating.xml

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: pkgsrc/doc/guide/files/creating.xml
diff -u pkgsrc/doc/guide/files/creating.xml:1.29 pkgsrc/doc/guide/files/creating.xml:1.30
--- pkgsrc/doc/guide/files/creating.xml:1.29    Wed Aug 14 17:26:31 2019
+++ pkgsrc/doc/guide/files/creating.xml Wed Aug 14 17:31:34 2019
@@ -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 @@ package should be reviewed for correctne
 
 </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">