HowTo Create A Release for Emle

Overview

• launchpad.net has the source code repository for Emle under the Emle-Devlopers Team.
• SourceForge has the release and download system for Emle.
• SourceForge has the product web site for Emle.

Key

• Green - text to be used exactly as shown.
• Red - text to be replaced with actual values.

Steps

1. Identify changes since previous release, determine new release name, and update the developer notes.
   1. List exiting release names.
      • bzr tags --directory lp:emle
   2. Use the most recent tag to get changes since it.
      • bzr log --revision 'tag:Emle 3.2-4 (BL0122)'.. --line bzr+ssh://bazaar.launchpad.net/~emle-dev/emle/2.0/
   3. Use the list of changes to determine if the new release is a:
      • MajorRelease
      • DotRelease
      • DashRelease
   4. Then edit the contents of:
      • work/lp:emle/emle/dev/notes.txt
   5. Commit to bzr. Use just "Emle 3.2-5 (BL0123)" as the commit comment.
   Use these notes in step 1.b.iv below.
2. Modify version strings (for example: 3.2-4 -> 3.2-5) in the source code.
   1. Change these files
   2. Commit to bzr. Use just "Emle 3.2-5 (BL0123)" as the commit comment.
   There may be more than one occurrence of the release name in some of the files. These files are located in work/lp:emle/:
   • emle/dev/web_site.html
   • emle/emle_lab.css
   • emle/emle_index.html
   • emle/include/menu.htmli
   • htdocs/include/index.htmli
   • htdocs/include/menu.htmli # emle030405_BL0123.tar, add release_id after Step 8 before web site update.
   • htdocs/index_old_versions.html # add link to previous: emle030404_BL0122
3. Tag the source code and build the release.
   • cd work/emle.sf.net;rm --recursive
   • bzr tag 'Emle 3.4-5 (BL0123)' --directory lp:emle
   • bzr export --revision 'tag:Emle 3.4-5 (BL0123)' ../emle.sf.net/emle030405_BL0123.tar lp:emle
4. Create SourceForge release notes.

   This step is done first in order to obtain a release id from SourceForge. It will be used in links within web pages that are to be part of this release.

   1. Add a new release to the existing package(emleFF) in SourceForge:
      1. https://sourceforge.net/project/admin/explorer.php?group_id=45154
      2. SourceForge.net
         EMLE - Electronic Math Lab Equipment
         File Manager
         [emleFF]
      3. Create A New Folder
         New Folder Name: [3.2-5 (BL0123)]
         [OK]
      4. SourceForge.net
         EMLE - Electronic Math Lab Equipment
         Step 1: Edit Existing Release - Paste The Change Log In:

         Copy and paste from the previous release adding the contents from 1.a.ii above.

      5. Submit change notes.
         Step 1: -> [Submit/Refresh]
5. Upload tar release file to SourceForge from work/emle.sf.net.
   1. Follows steps in 1 above to get the SourceForge create a new release page.
   2. Step 2: Add Files To This Release
   3. Follow the "upload new files" link
   4. In the "Web Upload" section follow the "Web upload page" link.
   5. Authentication Required...[Login]
   6. File Release System: Upload a File - Browse
   7. work/emle.sf.net/emle030205_BL0123.tar
   8. [Upload File]
   9. It should list the file in the table titled "The current contents of your uploads dir:"
6. Add uploaded file to the new Emle release.
   1. Follows steps in 1 above to get the SourceForge create a new release page.
   2. Step 2: Add Files To This Release
   3. [x]emle030205_BL0123.tar - ... bytes
   4. [Add Files and/or Refresh View]
7. Enter Release info.
   1. Continue from above.
   2. Step 3: Edit Files In This Release
   3. Filename: emle030205_BL0123.tar
   4. Release: emleFF: 3.4-5 (BL0123)
   5. Processor: Platform Independent
   6. Release Date: 2008-06-21
   7. File Type: Other
   8. [Update/Refresh]
8. Release Emle.
   1. Continue from above.
   2. Step 1: Edit Existing Release
   3. Status: Active
   4. [Submit/Refresh]
9. See that it worked.
   1. Download - Browse All Packages
   2. "Latest File Releases" table should have:
      "emleFF: 3.4-5 (BL0123) Jun 12, 2008"
   3. Follow the link "3.4-5 (BL0123)"
   4. "You have selected to download the 3.4-5 (BL0123) release. "
   5. Under "Latest 3.4-5 (BL0123) Notes (2008-06-12 10:02)" follow the link "emle030205_BL0123.tar"
10. Untar the file and verify it works correctly.
11. Follow instructions in SourceForge Project Emle
    Developer Documentation "HowTo Update Web Site with a New Release for Emle"
12. Follow instructions in SourceForge Project Emle
    Developer Documentation "HowTo Setup CVS Sandbox for Emle"
13. Update documentation on other sites http://sugarlabs.org/go/User:Cwhii

22-Mar-2010 C.W.Holeman II