


Release(Cook)                                       Release(Cook)


NAME
       How to release a version of Cook

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

Verify Current Baseline
       Take the archive/cook-2.20.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.

Cut AA New Version
       The releases are post-numbered 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.20), and the release notes file for next
         release (lib/en/readme/new.2.20.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)


UPLOAD TO THE ARCHIVES
       There are two archives to upload to.

   Update Primary Archive
       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).

              % aecd -bl archive
              % ftp ftp.canb.auug.org.au
              user: millerp
              ftp> binary
              ftp> cd WWW/cook
              ftp>

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

              ftp> prompt
              ftp> mdelete cook*
              ftp>

       Transfer the new version

              ftp> mput cook*
              ftp> quit
              %


   Update Linux Archive
       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

              % aecd -bl archive
              % ftp sunsite.unc.edu
              user: anonymous
              ftp> cd /incoming/Linux
              ftp> binary
              ftp> prompt
              ftp> mput cook-*
              ftp> quit
              %


       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)


NOTIFICATIONS
       A couple of mailing lists and newsgroups need to be
       notified.

   Notify Mailing Lists
       Send a notification to the cook-users@canb.auug.org.au and
       aegis-users@canb.auug.org.au lists.  It should look like
       this:

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

              I am pleased to announce that Cook 2.20 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 make(1)
              tool.  However, it is necessary to convert
              makefiles into cookbooks using the make2cook
              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.20.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 make(1) tool.  And Cook doesn't
              interpret tab differently to 8 space characters!

              put your .sig file here


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

   Notify Newsgroups
       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.20 - file construction tool
              Reply-To: Peter Miller <millerp@canb.auug.org.au>

              I am pleased to announce that Cook 2.20 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 make(1)
              tool.  However, it is necessary to convert
              makefiles into cookbooks using the make2cook
              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.20.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 make(1) tool.  And Cook doesn't
              interpret tab differently to 8 space characters!

              put your .sig file here


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

   Update Mailing List Info
       Update the cook-users list info, by sending email

              To: majordomo@canb.auug.org.au

              newinfo cook-users password

              attach the README file here










Release Notes                  Cook                             4





Release(Cook)                                       Release(Cook)


   Notify Linux Announce
       Send a notification to the comp.os.linux.announce list.
       It should look like this:

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

              I am pleased to announce that Cook 2.20 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 make(1)
              tool.  However, it is necessary to convert
              makefiles into cookbooks using the make2cook
              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.20.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 make(1) tool.  And Cook doesn't
              interpret tab differently to 8 space characters!

              put your .sig file here


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

   Update Slash Dot
       Go to http://www.freshmeat.net/ and update the info for
       Cook.













Release Notes                  Cook                             5





Release(Cook)                                       Release(Cook)


COPYRIGHT
       cook version 2.20
       Copyright (C) 1988, 1989, 1990, 1991, 1992, 1993, 1994,
       1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002 Peter
       Miller; All rights reserved.

       The cook program comes with ABSOLUTELY NO WARRANTY; for
       details use the 'cook -VERSion License' command.  This is
       free software and you are welcome to redistribute it under
       certain conditions; for details use the 'cook -VERSion
       License' command.

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










































Release Notes                  Cook                             6


