maxrelease

git-svn-id: svn://tug.org/texlive/trunk@18289 c570f23f-e606-0410-a88d-b1316a301751

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)