[pkgsrc/trunk]: pkgsrc/doc/guide/files Add a description of 'make upload-dist...

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

details:   https://anonhg.NetBSD.org/pkgsrc/rev/2a1a248e90e0
branches:  trunk
changeset: 400244:2a1a248e90e0
user:      brook <brook%pkgsrc.org@localhost>
date:      Sun Aug 25 17:11:00 2019 +0000

description:
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.

diffstat:

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

diffs (29 lines):

diff -r 02e0f1878381 -r 2a1a248e90e0 doc/guide/files/creating.xml
--- a/doc/guide/files/creating.xml      Sun Aug 25 16:37:28 2019 +0000
+++ b/doc/guide/files/creating.xml      Sun Aug 25 17:11:00 2019 +0000
@@ -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 @@
 <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>