[gtk-doc] HACKING: streamline release process more

[Stefan Sauer <stefkost src gnome org>]

commit 24e725cc4c46a6a2fea9ad9597f51c1174312c72
Author: Stefan Sauer <ensonic users sf net>
Date:   Thu Aug 15 21:15:33 2019 +0200

    HACKING: streamline release process more

 HACKING | 54 ++++++++++++++++++++++++++++--------------------------
 1 file changed, 28 insertions(+), 26 deletions(-)
---
diff --git a/HACKING b/HACKING
index 9cd9f3f..30f43fb 100644
--- a/HACKING
+++ b/HACKING
@@ -18,11 +18,13 @@ Releasing
 
 http://live.gnome.org/MaintainersCorner/Releasing
 
-export OLD_VER=1.28
-export NEW_VER=1.29
+'''shell
+export OLD_VER=1.31
+export NEW_VER=1.32
 export OLD_VER_TAG=$(echo ${OLD_VER} | tr '.' '_')
 export NEW_VER_TAG=$(echo ${NEW_VER} | tr '.' '_')
 export GNOME_USER=...
+```
 
 - bump release date in:
   help/manual/C/index.docbook
@@ -35,35 +37,35 @@ export GNOME_USER=...
   grep "Author:" ChangeLog-${NEW_VER} | sed 's/Author:\(.*\)\ <.*>/\1/' | sort | uniq >RELNOTES.txt
   and then copy to NEWS
 
-- commit
-  git add configure.ac meson.build NEWS help/manual/C/index.docbook
-  git commit -m"release: update news and date in manual"
-  git push
+```shell
+# commit
+git add configure.ac meson.build NEWS help/manual/C/index.docbook
+git commit -m"release: update news and date in manual"
+git push
 
-- dist
-   TAR_OPTIONS="--owner=root --group=root" make distcheck
+# dist
+TAR_OPTIONS="--owner=root --group=root" make distcheck
 
-- tag
-  git tag -a GTK_DOC_${NEW_VER_TAG} -m"release: ${NEW_VER}"
-  git push origin GTK_DOC_${NEW_VER_TAG}
+# tag
+git tag -a GTK_DOC_${NEW_VER_TAG} -m"release: ${NEW_VER}"
+git push origin GTK_DOC_${NEW_VER_TAG}
 
-- release
-  scp gtk-doc-${NEW_VER}.tar.xz ${GNOME_USER}@master.gnome.org:
-  scp NEWS ${GNOME_USER}@master.gnome.org:gtk-doc-${NEW_VER}.news
-  scp ChangeLog-${NEW_VER} ${GNOME_USER}@master.gnome.org:gtk-doc-${NEW_VER}.changes
-  ssh <user>@master.gnome.org
-  ftpadmin install gtk-doc-1.XX.tar.xz
-  exit
+# release
+scp gtk-doc-${NEW_VER}.tar.xz ${GNOME_USER}@master.gnome.org:
+scp NEWS ${GNOME_USER}@master.gnome.org:gtk-doc-${NEW_VER}.news
+scp ChangeLog-${NEW_VER} ${GNOME_USER}@master.gnome.org:gtk-doc-${NEW_VER}.changes
+ssh ${GNOME_USER}@master.gnome.org "ftpadmin install gtk-doc-${NEW_VER}.tar.xz"
+```
 
 - bump versions in:
-  configure.ac meson.build
-  help/manual/C/index.docbook
-  NEWS
+  configure.ac meson.build help/manual/C/index.docbook NEWS
 
-- commit
-  git add configure.ac meson.build NEWS help/manual/C/index.docbook
-  git commit -m"release: bump versions and back to development"
-  git push
+``'shell
+# commit
+git add configure.ac meson.build NEWS help/manual/C/index.docbook
+git commit -m"release: bump versions and back to development"
+git push
+```
 
 - update web-pages (gtk-web/gtk-doc)
   git add gtk-doc/news.php
@@ -124,4 +126,4 @@ cd test; make coverage
 Find Dead Code
 ==============
 sudo pip3 install vulture
-PYTHONPATH=$PWD vulture gtkdoc/*.py gtkdoc-*.in
\ No newline at end of file
+PYTHONPATH=$PWD vulture gtkdoc/*.py gtkdoc-*.in