From 0708ab7655285f89a28ebf83236c77cdf0af1809 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sun, 16 May 2010 18:45:36 +0000 Subject: maxrelease git-svn-id: svn://tug.org/texlive/trunk@18289 c570f23f-e606-0410-a88d-b1316a301751 --- Master/tlpkg/doc/repository-setup.txt | 33 ++++++++++++++++++--------------- 1 file changed, 18 insertions(+), 15 deletions(-) (limited to 'Master/tlpkg/doc/repository-setup.txt') 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) -- cgit v1.2.3