summaryrefslogtreecommitdiff
path: root/Master/tlpkg/doc/repository-setup.txt
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2010-05-16 18:45:36 +0000
committerKarl Berry <karl@freefriends.org>2010-05-16 18:45:36 +0000
commit0708ab7655285f89a28ebf83236c77cdf0af1809 (patch)
tree0418765c1afe47517b15b7bd41728c07bbdea940 /Master/tlpkg/doc/repository-setup.txt
parent9b042a93e8f489c694af2e2e121e5aedd7671d8a (diff)
maxrelease
git-svn-id: svn://tug.org/texlive/trunk@18289 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/tlpkg/doc/repository-setup.txt')
-rw-r--r--Master/tlpkg/doc/repository-setup.txt33
1 files changed, 18 insertions, 15 deletions
diff --git a/Master/tlpkg/doc/repository-setup.txt b/Master/tlpkg/doc/repository-setup.txt
index e55c2d1ab9b..adfded61e32 100644
--- a/Master/tlpkg/doc/repository-setup.txt
+++ b/Master/tlpkg/doc/repository-setup.txt
@@ -1,11 +1,9 @@
$Id$
+(This document is public domain.)
How to set up your own TeX Live Packages repository
===================================================
-
-(This document is public domain.)
-
-TeX Live 2008 (and later) contains the TeX Live Manager, which allows
+TeX Live 2008 and later contain the TeX Live Manager, which allows
updates over the network. By specifying different installation sources
the user can in theory install packages using tlmgr from a different
source as the default TeX Live repository.
@@ -14,9 +12,8 @@ This document describes how to set up a repository in a way that tlmgr
can use it. Possible applications include distribution of company-internal
packages or non-free stuff not included in TeX Live.
-Note that this document is very much work in progress (as is most of the
-TeX Live infrastructure). If you have any questions please contact us
-at tex-live@tug.org.
+Multiple repository support is very much work in progress.
+Write tex-live@tug.org if questions or suggestions.
Contents
--------
@@ -71,8 +68,8 @@ You need from the TeX Live Repository (see http://www.tug.org/texlive/svn/)
the contents of at least
Master/tlpkg/TeXLive the perl modules
Master/tlpkg/bin the scripts for managing
-These files can be checked out via svn, or downloaded from the net. We
-recommend the first variant so that you can update them regularly.
+These files can be checked out via svn, or downloaded from the net.
+We recommend svn, so that you can easily update them regularly.
2. Preparing your repository
@@ -110,6 +107,7 @@ lines:
depend container_split_doc_files
depend container_format/xz
depend release/NNNN-YOUR_ID
+ depend maxrelease/MMMM-YOUR_ID
The "container_split_src_files" and "container_split_doc_files" are
options, they specify whether at a later stage the container script will
@@ -119,13 +117,18 @@ all of them into one .tar.xz. It is up to you.
The
depend container_format/xz
is *obligatory* because currently we do NOT support any other format.
-Finally the
+
+Finally, the
depend release/NNNN-YOUR_ID
-is necessary to keep repositories tied to a release. You have to use
-for NNNN the current year. If tlmgr finds something different then
-the current release year in the first 4 characters it will refuse
-to operate. So a typical example would be
- depend release/2009-mycompany
+ depend maxrelease/MMMM-YOUR_ID
+determine(s) which release(s) of TL your repository works with.
+If maxrelease is present, the year specified in $TLConfig::ReleaseYear
+must be in the range [release,maxrelease]. Otherwise the release/NNNN
+value must exactly match the the TL release number NNNN.
+For example, you might have:
+ depend release/2009-myorg
+and if your packages work with both TL'09 and TL'10, you could add:
+ depend maxrelease/2010-myorg
For the rest of your package you should create .tlpsrc files describing
their content. Either copy one of our .tlpsrc files, or (much better)