


Release(Cook)                                       Release(Cook)


NNAAMMEE
       How to release a version of Cook

CCHHEECCKKLLIISSTT
       This document describes the steps involved in issuing a new release of
       Cook.  The level of detail is too much in some places, and too little
       in others.

VVeerriiffyy CCuurrrreenntt BBaasseelliinnee
       Take the archive/cook-2.21.tar.gz file from the current baseline.
       Unpack it an verify that it configures and builds on each of the HP/UX,
       SunOs, Solaris, OSF/1 and AIX flavors.  There are usually small
       niggling problems (some of them are such bad UNIX implementations).
       Fix the problems and try again.

CCuutt AA NNeeww VVeerrssiioonn
       The releases are _p_o_s_t_-_n_u_m_b_e_r_e_d so that you must end the current branch
       and start a new branch with the desired release number.  This allows
       you to cut bug-fix sub-branches with sensible numbers when you want to
       release a bug fix.

       +o Set the project to one level up, and do a develop end on the current
         branch.

       +o Review it (hopefully without finding anything wrong),

       +o and the integrate it you normally would.

       +o Create a new branch for the release, and a new change on that branch.

       +o Create the change file for the last release (etc/CHANGES.2.21), and
         the release notes file for next release (lib/en/readme/new.2.21.so).

       +o When you integrate, use the -MINIMum option so that the version
         number in the documentation is correct.  Do a full regression test.

       +o Set your default project to the new branch.

       Resume these instructions once the new branch has been updated by this
       change.  Then these instructions will have the new version number in
       them, and you will be able to cut-and-paste from the text file straight
       into the xterm session.

UUPPLLOOAADD TTOO TTHHEE AARRCCHHIIVVEESS
       There are two archives to upload to.

   UUppddaattee PPrriimmaarryy AArrcchhiivvee
       Transfer a copy to http://www.canb.auug.org.au/~millerp/ by FTP.  Login
       as millerp and change to the WWW/cook directory (this corresponds to
       the /~millerp/cook/ directory for WWW clients).

              % aaeeccdd --bbll aarrcchhiivvee
              % ffttpp ffttpp..ccaannbb..aauuuugg..oorrgg..aauu
              user: mmiilllleerrpp



Release Notes                  Cook                             1





Release(Cook)                                       Release(Cook)


              ftp> bbiinnaarryy
              ftp> ccdd WWWWWW//ccooookk
              ftp>

       Delete the old version of Cook, to keep the space to a minimum.

              ftp> pprroommpptt
              ftp> mmddeelleettee ccooookk**
              ftp>

       Transfer the new version

              ftp> mmppuutt ccooookk**
              ftp> qquuiitt
              %


   UUppddaattee LLiinnuuxx AArrcchhiivvee
       Transfer a copy to sunsite.unc.edu by FTP.

       First check ftp://sunsite.unc.edu/pub/Linux/HOW.TO.SUBMIT and
       ftp://sunsite.unc.edu/pub/Linux/LSM-TEMPLATE to see if anything has
       changed.

       Login as anonymous and change to the /incoming/Linux directory.  Use
       the following commands

              % aaeeccdd --bbll aarrcchhiivvee
              % ffttpp ssuunnssiittee..uunncc..eedduu
              user: aannoonnyymmoouuss
              ftp> ccdd //iinnccoommiinngg//LLiinnuuxx
              ftp> bbiinnaarryy
              ftp> pprroommpptt
              ftp> mmppuutt ccooookk--**
              ftp> qquuiitt
              %


       The incoming directory is scanned, and the files placed into the
       archive automatically.  There is no need to send email to the archive
       maintainer.

NNOOTTIIFFIICCAATTIIOONNSS
       A couple of mailing lists and newsgroups need to be notified.

   NNoottiiffyy MMaaiilliinngg LLiissttss
       Send a notification to the _c_o_o_k_-_u_s_e_r_s_@_c_a_n_b_._a_u_u_g_._o_r_g_._a_u and _a_e_g_i_s_-
       _u_s_e_r_s_@_c_a_n_b_._a_u_u_g_._o_r_g_._a_u lists.  It should look like this:

              To: aegis-users@canb.auug.org.au, cook-users@canb.auug.org.au
              Subject: Cook 2.21 - file construction tool
              Reply-To: Peter Miller <millerp@canb.auug.org.au>

              I am pleased to announce that Cook 2.21 is now available.



Release Notes                  Cook                             2





Release(Cook)                                       Release(Cook)


              The cook program is a tool for constructing files, and
              maintaining referential integrity between files.

              Cook is a replacement for the traditional _m_a_k_e(1) tool.
              However, it is necessary to convert makefiles into cookbooks
              using the _m_a_k_e_2_c_o_o_k utility included in the distribution.

              You are invited to visit
                         http://www.canb.auug.org.au/~millerp/cook/
              for a more complete description of what Cook is, and access to
              the download files.  New features and bug fixes are described in
              the cook-2.21.README file.

              If you are putting together a source-code distribution and
              planning to write a makefile, consider writing a cookbook
              instead.  Although Cook takes a day or two to learn, it is much
              more powerful and a bit more intuitive than the traditional
              _m_a_k_e(1) tool.  And Cook doesn't interpret tab differently to 8
              space characters!

              _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.

   NNoottiiffyy NNeewwssggrroouuppss
       Send a notification to the newsgroups can also be notified by email,
       which tends to work best as not all newsgroups are sufficiently
       available elsewhere.  It should look like this:

              To: mail2news@replay.com
              Newsgroups: alt.sources.d, comp.software-eng,
                      comp.software.config-mgmt, comp.sources.d, gnu.announce
              Subject: Cook 2.21 - file construction tool
              Reply-To: Peter Miller <millerp@canb.auug.org.au>

              I am pleased to announce that Cook 2.21 is now available.

              The cook program is a tool for constructing files, and
              maintaining referential integrity between files.

              Cook is a replacement for the traditional _m_a_k_e(1) tool.
              However, it is necessary to convert makefiles into cookbooks
              using the _m_a_k_e_2_c_o_o_k utility included in the distribution.

              You are invited to visit
                         http://www.canb.auug.org.au/~millerp/cook/
              for a more complete description of what Cook is, and access to
              the download files.  New features and bug fixes are described in
              the cook-2.21.README file.

              If you are putting together a source-code distribution and
              planning to write a makefile, consider writing a cookbook



Release Notes                  Cook                             3





Release(Cook)                                       Release(Cook)


              instead.  Although Cook takes a day or two to learn, it is much
              more powerful and a bit more intuitive than the traditional
              _m_a_k_e(1) tool.  And Cook doesn't interpret tab differently to 8
              space characters!

              _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.

   UUppddaattee MMaaiilliinngg LLiisstt IInnffoo
       Update the cook-users list info, by sending email

              To: majordomo@canb.auug.org.au

              newinfo cook-users _p_a_s_s_w_o_r_d

              _a_t_t_a_c_h _t_h_e _R_E_A_D_M_E _f_i_l_e _h_e_r_e


   NNoottiiffyy LLiinnuuxx AAnnnnoouunnccee
       Send a notification to the comp.os.linux.announce list.  It should look
       like this:

              To: linux-announce@news.ornl.gov
              Subject: Cook 2.21 - file construction tool
              Reply-To: Peter Miller <millerp@canb.auug.org.au>

              I am pleased to announce that Cook 2.21 is now available.

              The cook program is a tool for constructing files, and
              maintaining referential integrity between files.

              Cook is a replacement for the traditional _m_a_k_e(1) tool.
              However, it is necessary to convert makefiles into cookbooks
              using the _m_a_k_e_2_c_o_o_k utility included in the distribution.

              You are invited to visit
                         http://www.canb.auug.org.au/~millerp/cook/
              for a more complete description of what Cook is, and access to
              the download files.  New features and bug fixes are described in
              the cook-2.21.README file.

              If you are putting together a source-code distribution and
              planning to write a makefile, consider writing a cookbook
              instead.  Although Cook takes a day or two to learn, it is much
              more powerful and a bit more intuitive than the traditional
              _m_a_k_e(1) tool.  And Cook doesn't interpret tab differently to 8
              space characters!

              _p_u_t _y_o_u_r .sig _f_i_l_e _h_e_r_e





Release Notes                  Cook                             4





Release(Cook)                                       Release(Cook)


       Only send this notification _a_f_t_e_r the files are actually available at
       the archive site.

   UUppddaattee SSllaasshh DDoott
       Go to http://www.freshmeat.net/ and update the info for Cook.

CCOOPPYYRRIIGGHHTT
       _c_o_o_k version 2.21
       Copyright (C) 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996,
       1997, 1998, 1999, 2000, 2001, 2002 Peter Miller; All rights reserved.

       The _c_o_o_k program comes with ABSOLUTELY NO WARRANTY; for details use the
       '_c_o_o_k _-_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 '_c_o_o_k _-_V_E_R_S_i_o_n _L_i_c_e_n_s_e' command.

AAUUTTHHOORR
       Peter Miller   E-Mail:   millerp@canb.auug.org.au
       /\/\*             WWW:   http://www.canb.auug.org.au/~millerp/






































Release Notes                  Cook                             5


