Skip to content

Latest commit

 

History

History
46 lines (38 loc) · 1.73 KB

RELEASING.md

File metadata and controls

46 lines (38 loc) · 1.73 KB

Cutting a release

This provides instructions for publishing a new guiguts release on Github.

  1. Ensure the version of ebookmaker to be bundled with the Windows release is the latest version as used online at PG. Build and release the latest version using the ebm_builder repo. Set the correct ebookmaker version number in tools/ebookmaker/package.sh

  2. Update the guiguts version. This needs to happen in two places:

    • Makefile
    • guiguts.pl
  3. Update the CHANGELOG.md

  4. Commit the version update changes and tag the release (ie: git tag r<version>) and push it up to github

  5. From a Linux or MacOS system, or a Windows system with MinGW installed, confirm that you are working from a clean git checkout. Then build the three releases using make or make all or

    make win
    make mac
    make generic
    

    This creates three .zip files, one for each platform.

    Be certain to keep the format guiguts-platform-1.0.0.zip (platform and version number will vary) in order for the update mechanism to work correctly. Do not include settings.rc or header.txt as these may have been modified by the user and will be created if they do not exist. The Makefile takes care of this.

  6. Publish the release on Github.com

    1. Log into github.com
    2. Access the guiguts releases
    3. Select Draft a new release
    4. Specify the tag (ie: r<version>)
    5. Specify the title (ie: <version>)
    6. Describe the release - can be a copy/paste of the CHANGELOG.md details for the release
    7. Attach the .zip files
    8. Publish release