RELEASE_INSTRUCTIONS
17f4f39d
 Instructions for s3cmd maintainers for doing a tagged release and publishing on sourceforge.net.
 In the below, 1.5.0-rc1 is the example version being released.  Salt to taste.
 
 1.  Make a fresh clone of the repo:
    git clone ssh+git://git@github.com/s3tools/s3cmd s3cmd-release
 
 2.  Run ./run-tests.py to verify it all works OK.
 
 3.  Update version to 1.5.0-rc1 in S3/PkgInfo.py
 
 4.  Update manpage with ./s3cmd --help | ./format-manpage.pl > s3cmd.1
 
 5.  Update NEWS with info about new features. Best to extract from git
     with:  git log --no-merges v1.5.0-beta1..
     (list all tags with: "git tag")
 
 
 6.  Verify the above changes:
     git diff --check && git diff
     git status
     (The only changed files should be NEWS, s3cmd.1, S3/PkgInfo.py)
 
 7.  Remove testsuite (intentionally inaccessible files break the next
     step):
     chmod -R +rwx testsuite/permission-tests/permission-denied-dir && rm -rf testsuite
 
 8.  Build the "Source Distribution":
     python setup.py sdist
     -> Creates dist/s3cmd-1.5.0-rc1.tar.gz and dist/s3cmd-1.5.0-rc1.zip
 
 9.  If everything worked fine commit the above changes:
     git commit -a -m "Update version to 1.5.0-rc1"
 
 10. Tag it:
     git tag --sign -a v1.5.0-rc1 -m "Tag v1.5.0-rc1"
 
 11. Push back to github:
7964ead5
     git push --tags
17f4f39d
 
 
 That's it for building the release. Now upload it to SourceForge:
 
 1.  Login to sf.net
 
 2.  Go to https://sourceforge.net/p/s3tools/admin/
 
 3.  Files -> s3cmd -> Add Folder -> Enter "1.5.0-rc1" -> Create
 
 4.  Go into 1.5.0-rc1 -> Add File -> upload dist/s3cmd-1.5.0-rc1.tar.gz
 
 5.  Once uploaded click the little "i" icon on the right and click
     "Select all" under "Default Download For:" to update the default
     download button to this new version.
 
 6.  Give it a few minutes and verify on the Summary page that the
     download button has been updated to s3cmd-1.5.0-rc1.tar.gz
 
 Now it's time to send out an announcement email to
 s3cmd-announce@lists.sourceforge.net and
 s3cmd-general@lists.sourceforge.net (check out the s3cmd-announce
 archive for an inspiration :)
 
 And the last step is to ask the respective distribution maintainers
 (Fedora, Debian, Ubuntu, OpenSuse, ...?) to update the package in
 their builds.