Release(Aegis)                                                  Release(Aegis)



[1mNAME[0m
        How to release a version of Aegis

[1mCHECKLIST[0m
        This document describes the steps involved in issuing a new release of
        Aegis.  It is a simple procedure, but there is enough to do, and it
        happens sufficiently rarely, that it was worth writing down.

[1mNEW BRANCH[0m
        The version stamping is [4mpost[24m-numbered.  You decide what major or minor
        version number you want as you are about to release, not when you
        start work.

        Finish development of the branch in the normal way.  For example, if
        you are working on project [4maegis.51.19[24m, then you would say

                % [1maede -p aegis.51 19[0m
                % [1maerpass -p aegis.51 19[0m
                % [1maeib -p aegis.51 19[0m
                % [1maed -p aegis.51 19[0m
                % [1maeb -p aegis.51 19[0m
                % [1maet -p aegis.51 19[0m
                % [1maet -reg -p aegis.51 -c 19[0m
                % [1maeipass -reg -p aegis.51 -c 19[0m
                %

        At this point, branch 19 if project [4maegis.51[24m is completed.  Cut a new
        branch, as follows

                % [1maenbr -p aegis.51 20[0m
                [1m%[0m

        The branch number will default.  This is OK unless you ever skipped a
        number - in which case it will back fill which is usually undesirable.

        At this point project [4maegis.51.20[24m is ready for use.  If you want a
        major version number increment, the process is similar, however you
        must also terminate the [4maegis.51[24m branch, and you may well want to
        create a branch on the branch, to get back to a two-number version
        scheme.

                aede -p aegis.51 19 [4met[24m [4mal,[24m [4mto[24m [4mcomplete[0m
                aede -p aegis 51 [4met[24m [4mal,[24m [4mto[24m [4mcomplete[0m
                aenbr -p aegis 52
                aenbr -p aegis 52 0

        The purpose of a [4mpost[24m-numbered branching scheme is that, at any point,
        you can cut a suitable bug-fix sub-branch.

   [1mVerify New Branch[0m
        Create a new change on the branch you just created, and start
        development of it.

        Update any version numbering files, or create any special release
        notes files, [4metc[24m, as required.  Much of this can be obtained from
        Aegis, but not all of it.

        Create a new change for the previous branch to preserve the change
        file of the just-released version.  Continuing the above example:

                % [1maenf etc/CHANGES.51.19[0m
                % bl*/etc/CHANGES.sh aegis.51.19 > etc/CHANGES.51.19
                [1m%[0m


   [1mVerify New Branch[0m
        The first pass of verifying the release set is to use the

                % [1maeb check-tarball[0m
                [4mlots[24m [4mof[24m [4moutput[0m
                %

        command.  This builds The tarball, and then unpacks it and builds
        Aegis from scratch.  It is a fairly vigorous test of the build and
        install, though highly Linux specific.  Fix any problems encountered.

        Take the archive/aegis.4.24.3.tar.gz file from the current change.
        Try it out on as many different architectures as you have access to.
        Try as many of these as you have access to: various Linux
        distributions (including AMD64), various BSD distributions, various
        Solaris versions, MacOSX, AIX, HP/UX, SGI.  Some are such bad
        implementations of Unix that you will almost always find something.

        Once you have fixed all of the problems, develop end and integrate the
        change as normal.  This creates the initial baseline for this branch;
        it will contain the appropriate version numbers for release.

[1mARCHIVES[0m
        Once a viable release is ready, it is necessary to upload it to the
        archives.

   [1mUpdate Primary Archive[0m
        The [4maeb[24m [4mcheck-tarball[24m step, above, produces a bunch of files suitable
        for installation on SourceForge to as the CGI interface.  This serves
        a s a demo of Aegis' distributed development facilities, and is also
        used by Aegis developers for just this use.  Upload the [4maegis-sf.tgz[0m
        file and unpack it

                % [1mscp aegis-sf.tgz aegis.sourceforge.net:.[0m
                % [1mssh aegis.sourceforge.net[0m
                [4mblah[24m [4mblah[0m
                %


        Transfer a copy to aegis.sourceforge.net by FTP.  Use the following
        commands

                % [1maecd -bl archive[0m
                % [1mscp -r . aegis.sourceforge.net:aegis.web/htdocs/.[0m
                %


        You also need to update the SourceForge download servers.  This is
        best done by using FTP from [4maegis.sourceforge.net[24m to
        [4mupload.sourceforge.net[24m as this is a fast internal SourceForge network
        transfer, and not a slower through-the-cloud transfer.

   [1mUpdate SourceForge Archive[0m
        Transfer a copy to upload.sourceforge.net by FTP.  Login as anonymous
        and change to the /incoming directory.  Use the following commands

                % [1maecd -bl archive[0m
                % ftp upload.sourceforge.net
                user: [1manonymous[0m
                ftp> [1mcd /incoming[0m
                ftp> [1mbinary[0m
                ftp> [1mput aegis-4.24.3.tar.gz[0m
                ftp> [1mput aegis-4.24.3.rm.pdf[0m
                ftp> [1mput aegis-4.24.3.ug.pdf[0m
                ftp> [1mquit[0m
                %


[1mNOTIFICATION[0m
        Once the archives are ready, you can let folks know it's there.

        Only send the notifications [4mafter[24m the files are actually available at
        the archive site.

   [1mSourceForge.Net[0m
        This is [4mway[24m harder than any sane person expects.  Go to
        http://sourceforge.net and login then go to
        http://sourceforge.net/projects/aegis/ and click the [1mAdmin [22mlink, and
        the [1mFile Releases [22mlink, and the [1m[Add Release] [22mlink (near the bottom of
        the page).  In the "[4mNew[24m [4mrelease[24m [4mname[24m" box put the version number, and
        click the "[4mCreate[24m [4mThis[24m [4mRelease[24m" button.  In the "[4mPaste[24m [4mThe[24m [4mNotes[24m [4mIn[24m"
        box type
                http://aegis.sourceforge.net/change_log.txt
        And then finish the rest of the rather cumbersome dialog gunk.

   [1mTranslation Project[0m
        Send a notification to the Translation Project
        [4mrobot@translationproject.org[24m list.  It should look like this:

                To: robot@translationproject.org
                Reply-To: millerp@canb.auug.org.au
                Subject: aegis-4.24.3.pot

                I am pleased to announce that Aegis 4.24.3 is now available.
                The tarball may be found at
                http://aegis.sourceforge.net/aegis-4.24.3.tar.gz

        Note that this is read and processed by a robot, so don't worry about
        the human-friendly language of the other notifications.

        Only send this notification [4mafter[24m the files are actually available at
        the archive site.

   [1mNotify Mailing List[0m
        Send a notification to the [4maegis-users@auug.org.au[24m list.  It should
        look like this:

                To: aegis-users@auug.org.au
                Reply-To: millerp@canb.auug.org.au
                Subject: Aegis 4.24.3 - a project change supervisor

                I am pleased to announce that Aegis 4.24.3 is now available.

                Aegis is a transaction-based software configuration management
                system.  It provides a framework within which a team of
                developers may work on many changes to a program
                independently, and Aegis coordinates integrating these changes
                back into the master source of the program, with as little
                disruption as possible.

                You are invited to visit
                                http://aegis.sourceforge.net/
                for a more complete description of what Aegis is, and access
                to the download files.

                If you are upgrading, please take the time to read the release
                notes, which may be found in the README file in the sources,
                or on the web site at
                         http://aegis.sourceforge.net/change_log.txt

                [4mput[24m [4myour[24m .sig [4mfile[24m [4mhere[0m


        Only send this notification [4mafter[24m the files are actually available at
        the archive site.

   [1mNotify Web[0m
        +o) Notify www.freshmeat.net that a new release of Aegis is available.
        Search for "aegis" as there is already an application record.

        +o Notify chris@absolutegiganten.org that a new release of Aegis is
        available, he's the Debian package maintainer.

[1mCOPYRIGHT[0m
        aegis version 4.24.3.D001
        Copyright (C) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
        2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 Peter
        Miller

        The aegis program comes with ABSOLUTELY NO WARRANTY; for details use
        the '[4maegis[24m [4m-VERSion[24m [4mLicense[24m' command.  This is free software and you
        are welcome to redistribute it under certain conditions; for details
        use the '[4maegis[24m [4m-VERSion[24m [4mLicense[24m' command.

[1mAUTHOR[0m
        Peter Miller   E-Mail:   millerp@canb.auug.org.au
        /\/\*             WWW:   http://www.canb.auug.org.au/~millerp/



Release Notes                        Aegis                      Release(Aegis)
