Update CHECKLIST.md
authorColin Clark <colin.clark@cclark.uk>
Mon, 17 Jan 2022 13:12:30 +0000 (13:12 +0000)
committerColin Clark <colin.clark@cclark.uk>
Mon, 17 Jan 2022 13:12:30 +0000 (13:12 +0000)
Include section for new releases.

CHECKLIST.md

index cb76f47..3cc7ae7 100644 (file)
@@ -1,6 +1,8 @@
-# Checklist for new releases of Geeqie
+# Checklist for code updates and new releases of Geeqie
 
-## Before compiling the sources, carry out the following actions when necessary
+## Code Updates
+
+### Before compiling the sources, carry out the following actions when necessary
 
 * Update `org.geeqie.Geeqie.appdata.xml.in` with the latest released version and date
 
@@ -24,7 +26,7 @@ make update-po
 ./scripts/template-desktop.sh
 ```
 
-## After compiling the sources, carry out the following actions when necessary
+### After compiling the sources, carry out the following actions when necessary
 
 * Update the man page and Command Line Options section in Help if the command line options have changed
 
@@ -58,3 +60,61 @@ make update-po
 * Copy `geeqie.desktop` to `<location of local geeqie.github.io>/`
 * Copy `org.geeqie.Geeqie.appdata.xml` to `<location of local geeqie.github.io>/`
 * Push changes to `geeqie.github.io`
+
+## New release
+
+Carry out the above actions to ensure the master branch is up to date, and then the following actions for new version \<n.m\>.
+
+```sh
+sudo make maintainer-clean
+
+git checkout -b stable/<n.m>
+git push git@geeqie.org:geeqie stable/<n.m>
+```
+
+Edit `org.geeqie.Geeqie.appdata.xml.in` - change date and version  
+Edit `NEWS` - the usual information
+
+```sh
+./autogen.sh
+make -j
+./scripts/generate-man-page.sh
+
+git add NEWS
+git add org.geeqie.Geeqie.appdata.xml.in
+git add geeqie.1
+git add doc/docbook/CommandLineOptions.xml
+git commit --message="Preparing for release v<n.m>"
+git push git@geeqie.org:geeqie
+
+git tag --sign v<n.m> --message="Release v<n.m>"
+git push git@geeqie.org:geeqie v<n.m>
+```
+
+Copy the changed files from the v\<n.m\> branch to master
+
+```sh
+git checkout master
+
+git checkout stable/<n.m> NEWS
+git checkout stable/<n.m> geeqie.1
+git checkout stable/<n.m> doc/docbook/CommandLineOptions.xml
+git checkout stable/<n.m> org.geeqie.Geeqie.appdata.xml.in
+
+git add NEWS
+git add org.geeqie.Geeqie.appdata.xml.in
+git add geeqie.1
+git add doc/docbook/CommandLineOptions.xml
+git commit --message="Release v<n.m> files"
+git push git@geeqie.org:geeqie
+```
+
+Go to `https://github.com/BestImageViewer/geeqie/releases` and click on `Draft a new release`.
+
+Under `Release title` insert "Geeqie \<n.m\>"
+
+Under `Choose a tag` select `v<n.m>`
+
+In `Describe this release` copy-paste the relevant section of `NEWS`.
+
+Click `Publish release`