texlive[46888] Master/tlpkg/doc/repository-setup.txt: more

[commits+preining at tug.org]

Revision: 46888
          http://tug.org/svn/texlive?view=revision&revision=46888
Author:   preining
Date:     2018-03-08 09:10:07 +0100 (Thu, 08 Mar 2018)
Log Message:
-----------
more improvements for repository-setup doc

Modified Paths:
--------------
    trunk/Master/tlpkg/doc/repository-setup.txt

Modified: trunk/Master/tlpkg/doc/repository-setup.txt
===================================================================
--- trunk/Master/tlpkg/doc/repository-setup.txt	2018-03-08 02:30:02 UTC (rev 46887)
+++ trunk/Master/tlpkg/doc/repository-setup.txt	2018-03-08 08:10:07 UTC (rev 46888)
@@ -61,7 +61,14 @@
 
 Finally you create/update your web distribution from that ROOT.
 
+The repository can then be used either on a one-time basis with
+  tlmgr --repository URL-of-your-repo <action>
+or by permanently adding it to the used repositories with
+  tlmgr repository add URL-of-your-repo <tagname>
+Please see the documentation of tlmgr (tlmgr -help or man tlmgr) for
+details.
 
+
 1. Prerequisites
 ----------------
 You need from the TeX Live Repository (see http://www.tug.org/texlive/svn/)
@@ -73,8 +80,8 @@
 
 Note that it is not necessary to have the above files and the files
 you are distributing in the same file hierarchy. It is completely valid
-to have a full checkout of TeX Live (svn or git) and use the scripts
-from there. See Section 9 for an example management script.
+to have a full or partial checkout of TeX Live (svn or git) and use 
+the scripts from there. See Section 9 for an example management script.
 
 
 
@@ -93,6 +100,8 @@
     NETROOT
   In TeX Live this would be the 'tlnet' folder.
 
+Note that ROOT and NETROOT should be different!
+
 Put all of YOUR files in a TDS compliant way into the texmf-dist folder:
 	ROOT/texmf-dist
 Usage of 'texmf' as tree is strongly discouraged but still possible.
@@ -131,8 +140,8 @@
 	depend release/NNNN-YOUR_ID
 
 and might optionally contain:
-	depend container_split_src_files
-	depend container_split_doc_files
+	depend container_split_src_files/1
+	depend container_split_doc_files/1
 	depend minrelease/MMMM-YOUR_ID
 
 The 
@@ -142,7 +151,9 @@
 The "container_split_src_files" and "container_split_doc_files" are
 options, they specify whether at a later stage the container script will
 generate separate .tar.xz archives for source and doc files, or put
-all of them into one .tar.xz. It is up to you.
+all of them into one .tar.xz. It is up to you. TeX Live uses splitting
+of src and doc files. For users there is hardly any difference.
+The default is splitting source and doc files out.
 
 Finally, the 
 	depend release/NNNN-YOUR_ID
@@ -164,6 +175,12 @@
 their content. Either copy one of our .tlpsrc files, or (much better) 
 PLEASE read the documentation of TLPSRC.pm (in POD format).
 
+For local packages or those that are not in the TeX catalogue it is
+nice to provide descriptions in the two fields
+  shortdesc
+  longdesc
+again, see the TLPSRC.pm documentation.
+
 If you want to use the auto-generated patterns we are using in TeX Live 
 you have to copy our 00texlive.autopatterns.tlpsrc into your tlpkg/tlpsrc
 directory.
@@ -189,9 +206,9 @@
 If you have set up all your local files, and the tlpsrc files, you can 
 create the TeX Live Database in ROOT/tlpkg/texlive.tlpdb by calling
 	perl PATH-TO/tl-update-tlpdb OPTIONS
-Here PATH-TO points to the directory Master/tlpkg/bin in your TeX Live
-checkout, or where you have saved the files from TeXLive and tlpkg 
-directories.
+from within ROOT. Here PATH-TO points to the directory Master/tlpkg/bin
+in your TeX Live checkout, or where you have saved the files from
+TeXLive and tlpkg directories.
 
 How revision numbers are computed and which files are used can be controlled
 by one of the several -from-XXXX options. By default Subversion is used.
@@ -276,7 +293,7 @@
 revision numbers are recreated. In the latter case all containers are
 created.
 
--master `pwd`
+-master ROOT
 The option -master defines the location of *your* files, that is ROOT
 in this document.
 
@@ -378,4 +395,4 @@
 let us know at tex-live at tug.org.
 
 
-Last changed 2018-02-13 by np
+Last changed 2018-03-08 by np