texlive[46620] Master/tlpkg: move necessary options to

[commits+preining at tug.org]

Revision: 46620
          http://tug.org/svn/texlive?view=revision&revision=46620
Author:   preining
Date:     2018-02-13 01:48:47 +0100 (Tue, 13 Feb 2018)
Log Message:
-----------
move necessary options to TL_GNUPGMAINOPTS

Modified Paths:
--------------
    trunk/Master/tlpkg/bin/tl-sign-file
    trunk/Master/tlpkg/doc/repository-setup.txt

Modified: trunk/Master/tlpkg/bin/tl-sign-file
===================================================================
--- trunk/Master/tlpkg/bin/tl-sign-file	2018-02-13 00:22:55 UTC (rev 46619)
+++ trunk/Master/tlpkg/bin/tl-sign-file	2018-02-13 00:48:47 UTC (rev 46620)
@@ -14,16 +14,19 @@
 prg=gpg
 gpgopts="--batch --homedir /home/texlive/.gnupg  \
   --passphrase-file /home/texlive/.gnupg/passphrase \
-  --armor --detach-sign --local-user 0x06BAB6BC "
+  --local-user 0x06BAB6BC "
+gpgmainopts="--armor --detach-sign"
 
+# use the environment variables if available
 if test -n "$TL_GNUPG" ; then
-  # use the environment variable TL_GNUPG
   prg=$TL_GNUPG
 fi
 if test -n "$TL_GNUPGOPTS" ; then
-  # use the environment variable TL_GNUPGOPTS
   gpgopts=$TL_GNUPGOPTS
 fi
+if test -n "$TL_GNUPGMAINOPTS" ; then
+  gpgmainopts=$TL_GNUPGMAINOPTS
+fi
 
 # sign
-"$prg" $gpgopts "$1"
+"$prg" $gpgmainopts $gpgopts "$1"

Modified: trunk/Master/tlpkg/doc/repository-setup.txt
===================================================================
--- trunk/Master/tlpkg/doc/repository-setup.txt	2018-02-13 00:22:55 UTC (rev 46619)
+++ trunk/Master/tlpkg/doc/repository-setup.txt	2018-02-13 00:48:47 UTC (rev 46620)
@@ -13,7 +13,7 @@
 packages or non-free stuff not included in TeX Live.
 
 The current document is based on the status of the TeX Live repository
-scripts as of 2018-02-12.
+scripts as of 2018-02-13.
 
 Please write tex-live at tug.org if questions or suggestions.
 
@@ -80,8 +80,18 @@
 
 2. Preparing your repository
 ----------------------------
-Create a root folder which will mirror our directory layout. We will call
-that root folder ROOT from now on.
+You will have to deal with two different folders on your system:
+* The preparation place, where you collect the files of the packages
+  and create the necessary configuration files.
+  We will refer to this folder as
+    ROOT
+  In TeX Live this would be the subversion repository.
+* The generated repository which will be synced to some web server
+  and accessed via tlmgr. This folder will be generated and maintained
+  by the scripts mentioned in this document.
+  We will refer to this folder as
+    NETROOT
+  In TeX Live this would be the 'tlnet' folder.
 
 Put all of YOUR files in a TDS compliant way into the texmf-dist folder:
 	ROOT/texmf-dist
@@ -170,7 +180,10 @@
 the TLPSRC.pm documentation (and don't forget to copy 
 00texlive.autopatterns.tlpsrc).
 
+For more documentation concerning patterns and autopatterns, see the
+POD documentation in TLPSRC.pm.
 
+
 4. Creating the TeX Live Database
 ---------------------------------
 If you have set up all your local files, and the tlpsrc files, you can 
@@ -203,6 +216,11 @@
 with the packages in the old one and checked that the revisions are
 increasing.
 
+Passing in 
+  -master ROOT
+should allow you to run the script from an arbitrary directory, but
+we recommend running it from within the ROOT folder.
+
 As usual, please read the documentation of tl-update-tlpdb (again in POD)
 for further information.
 
@@ -252,7 +270,7 @@
 	perl PATH-TO/tl-update-containers OPTIONS
 
 OPTIONS:
--location DEST
+-location NETROOT
 The -location gives the place where your former distribution was or where
 it should be created. In the former case only those containers with larger
 revision numbers are recreated. In the latter case all containers are
@@ -277,12 +295,12 @@
 ----------------------------
 Having completed all these steps, you can test your distribution by calling
 the TeX Live Manager with the location argument. Continuing the above
-example we use DEST:
-	tlmgr -location DEST update --list
+example we use NETROOT:
+	tlmgr -location NETROOT update --list
 or 
-	tlmgr -location DEST update --all
+	tlmgr -location NETROOT update --all
 or 
-	tlmgr -location DEST list
+	tlmgr -location NETROOT list
 etc.  Please see the documentation of tlmgr (POD again) for details.
 
 
@@ -292,7 +310,7 @@
 verify that the downloaded packages are what is distributed by the
 author/maintainer (you reading this document).
 
-If you don't to sign, please pass
+If you don't want to sign, please pass
   -no-sign
 to tl-update-containers above.