Re: packages and TeXLive revisions

[Leonardo Taccari <iamleot%gmail.com@localhost>]

Hello Brook and Thomas,

On Sat, Aug 30, 2014 at 11:34:50PM +0200, Thomas Klausner wrote:
> On Sat, Aug 30, 2014 at 08:49:35AM -0600, Brook Milligan wrote:
> > So I believe this is the basic idea of what happens based upon the contents 
> > of print/texlive/package.mk:
> > 
> > - If TEXLIVE_REV is not defined, the DIST_SUBDIR is ${PKGNAME_NOREV}, i.e., 
> > basically the normal package name.
> > - If TEXLIVE_REV is defined, the DIST_SUBDIR is ${PKGBASE} without any -doc 
> > suffix plus TEXLIVE_REV.
> > 
> > I think this means the following:
> > 
> > - If the package has a proper version, include that in the definition of 
> > PKGNAME and do not define TEXLIVE_REV (use a comment instead).
> > - If the package has no version, do not include any version in PKGNAME and 
> > define TEXLIVE_REV from the tlpkg/tlpobj/*.tlpobj file.
> > - There is no need to make any reference to DIST_SUBDIR as it will be set 
> > automatically.
> > 
> > Perhaps that just repeats what you said, but I wanted to be more explicit 
> > for future reference.  Does this sound about right?
> 
> That sounds about right. If you can find a good section in the pkgsrc
> guide, can you please add it there?
What do you think about the following (attached) diff
for print/texlive/package.mk? (something stolen from PR 49070 and big
inspiration from this mail too)


Ciao,
L.

Index: package.mk
===================================================================
RCS file: /cvsroot/pkgsrc/print/texlive/package.mk,v
retrieving revision 1.22
diff -u -r1.22 package.mk
--- package.mk  15 Dec 2013 06:02:02 -0000      1.22
+++ package.mk  30 Aug 2014 22:55:46 -0000
@@ -3,11 +3,28 @@
 # This Makefile fragment is intended to be included by packages that build
 # TeX Live packages.
 #
+# Note to package developers:
+# 
+#   * When creating/updating a tex package please set TEXLIVE_USE_CTAN (in
+#     order to properly update the distinfo via the "makesum" target) and
+#     set TEXLIVE_REV appropriately if it is possible (as described below).
+#
 # Package-settable variables:
 #
 # REPLACE_TEXLUA
 #      A list of texlua scripts to be installed, relative to ${WRKSRC}.
 #
+# TEXLIVE_IGNORE_PATTERNS
+#      glob patterns for files and directories in ${WRKSRC} that
+#      should not be installed.
+#
+# TEXLIVE_REV
+#      String appended to DIST_SUBDIR (useful because the majority of tex
+#      packages do not have a revision number in the DISTNAME).
+#      To obtain information to be used as TEXLIVE_REV you should use the
+#      value of "revision" line usually available in
+#      ${WRKSRC}/tlpkg/tlpobj/${DISTNAME}.tlpobj
+#
 # TEX_FORMATS
 #      See ../../print/tex-tetex/format.mk.
 #
@@ -19,10 +36,6 @@
 #
 # TEX_TEXMF_DIRS
 #      See ../../print/kpathsea/texmf.mk.
-#
-# TEXLIVE_IGNORE_PATTERNS
-#      glob patterns for files and directories in ${WRKSRC} that
-#      should not be installed.
 
 CATEGORIES?=   print
 .if empty(TEXLIVE_USE_CTAN)