From: Colin Clark <colin.clark@cclark.uk>
Date: Mon, 17 Jan 2022 13:12:30 +0000 (+0000)
Subject: Update CHECKLIST.md
X-Git-Tag: gtk2final~63
X-Git-Url: http://geeqie.org/cgi-bin/gitweb.cgi?p=geeqie.git;a=commitdiff_plain;h=732b69352c137572a462a577d2e6dd2a9e1972bf

Update CHECKLIST.md

Include section for new releases.
---

diff --git a/CHECKLIST.md b/CHECKLIST.md
index cb76f478..3cc7ae73 100644
--- a/CHECKLIST.md
+++ b/CHECKLIST.md
@@ -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`