texlive[46888] Master/tlpkg/doc/repository-setup.txt: more
commits+preining at tug.org
commits+preining at tug.org
Thu Mar 8 09:10:07 CET 2018
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
More information about the tex-live-commits
mailing list