From 785f0e189abd572fa2185b131a108df942c7b985 Mon Sep 17 00:00:00 2001
From: Vincent Sanders <vince@kyllikki.org>
Date: Tue, 28 Aug 2018 21:16:42 +0100
Subject: update release process

---
 release/process.mdwn | 100 ++++++++++++++++++++++++++++-----------------------
 1 file changed, 56 insertions(+), 44 deletions(-)

(limited to 'release')

diff --git a/release/process.mdwn b/release/process.mdwn
index 1dbba81..25e01c1 100644
--- a/release/process.mdwn
+++ b/release/process.mdwn
@@ -6,49 +6,12 @@
 [[!toc]]
 
 Releasing a new version of NetSurf and libraries
-------------------------------------------------
+================================================
 
-firstly the libraries and tool sources should be created (only if they
-need an update)
+firstly the libraries and tool sources must be created (only if they
+need an update) and then the browser itself.
 
-Order to release components in (if they require releasing)
-
-buildsystem is first and has an extra step
-
-Then libraries using the core buildsystem
-
--   libnspsl
--   libnslog
--   libnsutils
--   libwapcaplet
--   libparserutils
--   libcss
--   libhubbub
--   libdom
--   libnsbmp
--   libnsgif
--   librosprite
--   libnsfb
--   libsvgtiny
--   nsgenbind
--   libutf8proc
--   libpencil
--   librufl
-
-NetSurf itself is last
-
-Release of the buildsystem
---------------------------
-
-The buildsystem follows exactly the same process as below except there
-is an additional step
-
-Because this is the buildsystem and provides the makefiles for all the
-other source builds you must go to the CI server and ensure the
-source-buildsystem job has successfully run and produced output in
-<http://ci.netsurf-browser.org/builds/sources/>
-
-Release for projects using buildsystem
+Process for projects using buildsystem
 --------------------------------------
 
 We perform all releases from git simply by pushing a
@@ -124,6 +87,52 @@ If that verifies as correct
 
 and the release tag is pushed, too late now so be careful and check!
 
+Release the buildsystem
+-----------------------
+
+The buildsystem must be released first.
+
+The buildsystem follows exactly the same process as releasing any
+other component except there is an additional step
+
+Because this is the buildsystem and provides the makefiles for all the
+other source builds you must go to the CI server and ensure the
+source-buildsystem job has successfully run and produced output in
+<http://ci.netsurf-browser.org/builds/sources/>
+
+Release libnspsl
+----------------
+
+The public suffix list library should be updated for each release
+after the buildsystem..
+
+Delete the public_suffix_list.dat file and run make, this will cause a
+fresh copy to be downloaded and converted. You will need the correct
+perl modules installed for this step.
+
+Other core buildsystem based libraries
+--------------------------------------
+
+libraries using the core buildsystem in order
+
+-   libwapcaplet
+-   libnslog
+-   libnsutils
+-   libparserutils
+-   libcss
+-   libhubbub
+-   libdom
+-   libnsbmp
+-   libnsgif
+-   librosprite
+-   libsvgtiny
+-   nsgenbind
+-   libnsfb
+-   libpencil
+-   librufl
+-   libutf8proc
+
+
 Releasing NetSurf
 -----------------
 
@@ -148,10 +157,13 @@ check the resources for the frontends you are releasing are up to date
 - frontends/amiga/pkg/netsurf\_os3.readme
 - windows/res/installer.nsi
 
-create a branch release/<version number> and switch to it
+Ensure the ca-bundle is updated
+
+
+create a branch releasing/<version number> and switch to it
 
-    git branch release/3.8
-    git checkout release/3.8
+    git branch releasing/3.8
+    git checkout releasing/3.8
 
 update desktop/version.c to something like
 
-- 
cgit v1.2.3