


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.









Release Notes                  Cook                             1





Release(Cook)                                       Release(Cook)


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



Release Notes                  Cook                             2





Release(Cook)                                       Release(Cook)


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.

              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



Release Notes                  Cook                             3





Release(Cook)                                       Release(Cook)


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










Release Notes                  Cook                             4





Release(Cook)                                       Release(Cook)


   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


       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.













Release Notes                  Cook                             5





Release(Cook)                                       Release(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                             6


