CVS commit: pkgsrc/doc/guide/files

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

Module Name:    pkgsrc
Committed By:   brook
Date:           Sun Aug 25 17:11:00 UTC 2019

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

Log Message:
Add a description of 'make upload-distfiles' to the TeXlive package section.

TeXlive packages are unusual in avoiding direct downloads from the upstream
CTAN repository.  Therefore, developers must manually upload the appropriate
distfiles.  To help avoid forgetting this step, add a description to the
Pkgsrc Guide in the section describing TeXlive packages.


To generate a diff of this commit:
cvs rdiff -u -r1.30 -r1.31 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.30 pkgsrc/doc/guide/files/creating.xml:1.31
--- pkgsrc/doc/guide/files/creating.xml:1.30    Wed Aug 14 17:31:34 2019
+++ pkgsrc/doc/guide/files/creating.xml Sun Aug 25 17:11:00 2019
@@ -1,4 +1,4 @@
-<!-- $NetBSD: creating.xml,v 1.30 2019/08/14 17:31:34 brook Exp $ -->
+<!-- $NetBSD: creating.xml,v 1.31 2019/08/25 17:11:00 brook Exp $ -->
 
 <chapter id="creating">
 <title>Creating a new pkgsrc package from scratch</title>
@@ -248,6 +248,19 @@ texlive2pkg foo.tar.xz foo.doc.tar.xz
 <filename>tex-foo-doc</filename>.  Be sure to check that both packages
 are correct.</para>
 
+<para>Finally, <ulink url="https://www.ctan.org/";>CTAN</ulink>
+currently does not include version information in package filenames
+and changes their contents periodically when updates occur.
+Consequently, pkgsrc avoids downloading distfiles directly from <ulink
+url="https://www.ctan.org/";>CTAN</ulink> and instead relies on the
+pkgsrc archives.  For each new or updated TeXlive package, e.g., the
+main one and the corresponding documentation, upload the distfiles
+with the following command in each package directory.</para>
+
+<programlisting>
+make upload-distfiles
+</programlisting>
+
 </sect2>
 
 </sect1>