Create a Distribution


 * 1) How to Make a Gazebo Release

1. Write blog posts for the new features 1. Send tweet 1. Post on google+ account 1. Send email to mailing list.
 * 1) Communication


 * 1) One-time release setup

Before making your first release, you need to do a couple of things:

1. Learn the Jenkins token that's needed to kick off jobs. Ask somebody. 1. Have your public SSH key added to ubuntu@gazebosim.org to allow for tarball uploads. Ask somebody.


 * 1) Making a release

Making a Gazebo release involves the following steps:

1. Pull all desired changes into the branch you want to release from. You can release from any branch. 1. Edit the toplevel `CMakeLists.txt` file on that branch to contain the correct version number in `GAZEBO_MAJOR_VERSION`, `GAZEBO_MINOR_VERSION`, and `GAZEBO_PATCH_VERSION`. Commit that change. 1. In the `gazebo-release` repo: * edit `[precise|quantal]/debian/changelog` to have a new entry at the top of the file for the new version. Commit and push that change. * check `ubuntu/cmake/packager-hooks/gazebo.desktop` to ensure that the right `setup.sh` path is mentioned. If you're releasing a new minor release, you'll need to update it. If you do, commit and push that change. 1. Clone the `release-tools` repo to somewhere, say, `/tmp/release-tools`.

hg clone https://bitbucket.org/osrf/release-tools /tmp/release-tools

1. Go to your gazebo working copy (e.g., `cd ~/code/gazebo`). Make sure that you're on the branch you want to release from. 1. Run the release script, replacing and  as appropriate:

/tmp/release-tools/release.py gazebo 

1. Update documentation (see next section) 1. Update the ChangeLog in the wiki (TODO)


 * 1) Update Documentation

1. Make the documentation

make doc make gzsdf

1. Upload documentation

ssh ubuntu@gazebosim.org rm -rf /var/www/api/ scp -r doxygen/html/* ubuntu@gazebosim.org:/var/www/api/ scp doxygen/latex/gazebo-*.pdf ubuntu@gazebosim.org:/var/www/api/ scp -r doxygen_msgs/html/* ubuntu@gazebosim.org:/var/www/msgs/ scp doxygen_msgs/latex/gazebo-msgs-*.pdf ubuntu@gazebosim.org:/var/www/msgs/

1. Update SDF documentation. The following command should be run for each version of SDF

gzsdf doc [version] > [version].html

For example:

gzsdf doc 1.0 > 1.0.html gzsdf doc 1.2 > 1.2.html

If you're running from the `build` subdirectory (i.e., not installed), you need to set GAZEBO_RESOURCE_PATH, e.g.:

GAZEBO_RESOURCE_PATH=`pwd`/../gazebo/gazebo ./tools/gzsdf doc 1.2 > 1.2.html

Then upload the html files to the webserver:

scp sdf*.html ubuntu@gazebosim.org:/var/www/sdf