Release(Aegis)                                                  Release(Aegis)



NNAAMMEE
        How to release a version of Aegis

CCHHEECCKKLLIISSTT
        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.

NNEEWW BBRRAANNCCHH
        The version stamping is _p_o_s_t-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 _a_e_g_i_s_._5_1_._1_9, then you would say

                % aaeeddee --pp aaeeggiiss..5511 1199
                % aaeerrppaassss --pp aaeeggiiss..5511 1199
                % aaeeiibb --pp aaeeggiiss..5511 1199
                % aaeedd --pp aaeeggiiss..5511 1199
                % aaeebb --pp aaeeggiiss..5511 1199
                % aaeett --pp aaeeggiiss..5511 1199
                % aaeett --rreegg --pp aaeeggiiss..5511 --cc 1199
                % aaeeiippaassss --rreegg --pp aaeeggiiss..5511 --cc 1199
                %

        At this point, branch 19 if project _a_e_g_i_s_._5_1 is completed.  Cut a new
        branch, as follows

                % aaeennbbrr --pp aaeeggiiss..5511 2200
                %%

        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 _a_e_g_i_s_._5_1_._2_0 is ready for use.  If you want a
        major version number increment, the process is similar, however you
        must also terminate the _a_e_g_i_s_._5_1 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 _e_t _a_l_, _t_o _c_o_m_p_l_e_t_e
                aede -p aegis 51 _e_t _a_l_, _t_o _c_o_m_p_l_e_t_e
                aenbr -p aegis 52
                aenbr -p aegis 52 0

        The purpose of a _p_o_s_t-numbered branching scheme is that, at any point,
        you can cut a suitable bug-fix sub-branch.

   VVeerriiffyy NNeeww BBrraanncchh
        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, _e_t_c, 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:

                % aaeennff eettcc//CCHHAANNGGEESS..5511..1199
                % bl*/etc/CHANGES.sh aegis.51.19 > etc/CHANGES.51.19
                %%


   VVeerriiffyy NNeeww BBrraanncchh
        The first pass of verifying the release set is to use the

                % aaeebb RRPPMM
                _l_o_t_s _o_f _o_u_t_p_u_t
                %

        command.  This builds a RedHat package manager file.  It is a fairly
        vigorous test of the build and install, though highly Linux specific.
        Fix any problems encountered.

        Take the archive/aegis.4.16.tar.gz file from the current baseline.
        Unpack it and verify that it configures and builds on one of the
        Solaris boxes.  There are usually small niggling problems, so fix them
        and try again.

        Then unpack it on some other computer which is in the architecture
        list in the project _c_o_n_f_i_g file.  Configure, build and test it on this
        machine.

        Find yet another type of UNIX box and try again.  AIX or Pyramid are
        always good torture tests, they are such bad UNIX implementations.

        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.

AARRCCHHIIVVEESS
        Once a viable release is ready, it is necessary to upload it to the
        archives.

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

                % aaeeccdd --bbll aarrcchhiivvee
                % scp -r . aegis.sourceforge.net:aegis.web/htdocs/.
                %


   UUppddaattee LLiinnuuxx AArrcchhiivvee
        Transfer a copy to metalab.unc.edu by FTP.  Login as anonymous and
        change to the incoming/Linux directory.  Use the following commands

                % aaeeccdd --bbll aarrcchhiivvee
                % ftp metalab.unc.edu
                user: aannoonnyymmoouuss
                ftp> ccdd iinnccoommiinngg//LLiinnuuxx
                ftp> bbiinnaarryy
                ftp> pprroommpptt
                ftp> mmppuutt aaeeggiiss--**
                ftp> qquuiitt
                %


        There is no need to send email to _e_w_t_@_m_e_t_a_l_a_b_._u_n_c_._e_d_u, it will be
        archived automatically in a day or two (or fifteen).

   UUppddaattee SSoouurrcceeFFoorrggee AArrcchhiivvee
        Transfer a copy to upload.sourceforge.net by FTP.  Login as anonymous
        and change to the /incoming directory.  Use the following commands

                % aaeeccdd --bbll aarrcchhiivvee
                % ftp upload.sourceforge.net
                user: aannoonnyymmoouuss
                ftp> ccdd //iinnccoommiinngg
                ftp> bbiinnaarryy
                ftp> ppuutt aaeeggiiss--44..1166..ttaarr..ggzz
                ftp> qquuiitt
                %


NNOOTTIIFFIICCAATTIIOONN
        Once the archives are ready, you can let folks know its there.

        Only send the notifications _a_f_t_e_r the files are actually available at
        the archive site.

   SSoouurrcceeFFoorrggee..NNeett
        This is _w_a_y harder than any sane person expects.  Go to
        http://sourceforge.net and login then go to
        http://sourceforge.net/projects/aegis/ and click the AAddmmiinn link, and
        the FFiillee RReelleeaasseess link, and the [[AAdddd RReelleeaassee]] link (near the bottom of
        the page).  In the "_N_e_w _r_e_l_e_a_s_e _n_a_m_e" box put the version number, and
        click the "_C_r_e_a_t_e _T_h_i_s _R_e_l_e_a_s_e" button.  In the "_P_a_s_t_e _T_h_e _N_o_t_e_s _I_n"
        box type
                http://aegis.sourceforge.net/change_log.txt
        And then finish the rest of the rather cumbersome dialog gunk.

   TTrraannssllaattiioonn PPrroojjeecctt
        Send a notification to the Translation Project
        _t_r_a_n_s_l_a_t_i_o_n_@_i_r_o_._u_m_o_n_t_r_e_a_l_._c_a list.  It should look like this:

                To: translation@iro.umontreal.ca
                Reply-To: millerp@canb.auug.org.au
                Subject: aegis-4.16.pot

                I am pleased to announce that Aegis 4.16 is now available.
                The tarball may be found at
                http://aegis.sourceforge.net/aegis-4.16.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 _a_f_t_e_r the files are actually available at
        the archive site.

   NNoottiiffyy MMaaiilliinngg LLiisstt
        Send a notification to the _a_e_g_i_s_-_u_s_e_r_s_@_a_u_u_g_._o_r_g_._a_u list.  It should
        look like this:

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

                I am pleased to announce that Aegis 4.16 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

                _p_u_t _y_o_u_r .sig _f_i_l_e _h_e_r_e


        Only send this notification _a_f_t_e_r the files are actually available at
        the archive site.

   NNoottiiffyy NNeewwssggrroouuppss
        A variety of newsgroups are relevant to Aegis, so notify them that the
        release is available.

                To: mail2news@replay.com
                Subject: Aegis 4.16 - a project change supervisor
                Reply-To: millerp@canb.auug.org.au
                Followup-To: millerp@canb.auug.org.au
                Newsgroups: alt.sources.d, comp.sources.d, comp.software-eng,
                    comp.software.config-mgmt, gnu.announce

                I am pleased to announce that Aegis 4.16 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

                insert _._s_i_g file here

        Please note that the Newsgroups: line may not actually wrap, or have
        spaces around the commas.

   NNoottiiffyy LLiinnuuxx AAnnnnoouunnccee
        Send a notification to the _c_o_m_p_._o_s_._l_i_n_u_x_._a_n_n_o_u_n_c_e list.  It should
        look like this:

                To: linux-announce@news.ornl.gov
                Reply-To: millerp@canb.auug.org.au
                Subject: Aegis 4.16 - a project change supervisor

                I am pleased to announce that Aegis 4.16 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

                _p_u_t _y_o_u_r .sig _f_i_l_e _h_e_r_e


        Only send this notification _a_f_t_e_r the files are actually available at
        the archive site.

   NNoottiiffyy WWeebb
        +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 www.cmtoday.com that a new release of Aegis is available.

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

        +o Notify pr@32bitsonline.com that a new release of Aegis is available.

CCOOPPYYRRIIGGHHTT
        aegis version 4.16
        Copyright (C) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,
        2000, 2001, 2002, 2003, 2004 Peter Miller; All rights reserved.

        The aegis program comes with ABSOLUTELY NO WARRANTY; for details use
        the '_a_e_g_i_s _-_V_E_R_S_i_o_n _L_i_c_e_n_s_e' command.  This is free software and you
        are welcome to redistribute it under certain conditions; for details
        use the '_a_e_g_i_s _-_V_E_R_S_i_o_n _L_i_c_e_n_s_e' command.

AAUUTTHHOORR
        Peter Miller   E-Mail:   millerp@canb.auug.org.au
        /\/\*             WWW:   http://www.canb.auug.org.au/~millerp/



Release Notes                        Aegis                      Release(Aegis)
