[srvx-commits] New archive name (was: commit: Rotate ChangeLog for new repository; clarify documentation files)

[Michael P. <md...@tr...>]

Michael Poole writes:

> Revision: srvx--devo--1.3--patch-1
> Archive: sr...@sr...--2005-srvx

You may have noticed the new archive name for the new year.  This is a
fairly standard technique used with arch archives to put a limit on
the size of a repository.  However, I could not find good docs on how
one rotates an archive like that.  After a bit of trial and error, I
wrote the following (which is also part of
http://arch.srvx.net/~entrope/arch-for-cvs-users.html).  Read-only
users only need to take the steps mentioned in the third paragraph.

    Many arch developers use a technique called archive rotation to
    limit the number of patches tracked in a particular archive. The
    most common form of this is by embedding the year in the archive
    name; for example, md...@tr...--2004 versus
    md...@tr...--2005. This raises the question of how to
    easily update your archive and project trees.

    First you must create the new archive using tla make-archive in
    the normal fashion. You should update your ~/.arch-params/signing/
    entries to match. Then use tla tag -S OLD-VERSION NEW-VERSION to
    create the archive continuation. This only has to be done once.

    Updating your project tree is slightly easier, but must be done by
    each user; use tla replay NEW-VERSION to add the patch log, then
    tla set-tree-version NEW-VERSION to remember it as the default.

    If you use an automatically updated ChangeLog, you will probably
    want to rotate it, as well.

Michael Poole