RELEASE_INSTRUCTIONS

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:
    git push --tags


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.