1 files changed, 79 insertions, 0 deletions
diff --git a/RELEASING b/RELEASING
new file mode 100644
index 00000000..cfe3ea22
--- /dev/null
+++ b/RELEASING
@@ -0,0 +1,79 @@
+
+
+The ModemManager releases are generated using the GNU autotools.
+
+0.1) For major releases:
+     * Increment mm_minor_version and reset mm_micro_version.
+     * Assuming API/ABI compatibility in libmm-glib, increment both
+       mm_glib_lt_current and mm_glib_lt_age.
+
+0.2) For stable branch releases:
+     * Increment mm_micro_version.
+
+1) Configure and build the whole project, making sure gtk-doc is enabled:
+
+    $ NOCONFIGURE=1 ./autogen.sh
+    $ ./configure --enable-gtk-doc
+    $ make -j8
+
+2) Run distcheck so that the source distribution tarball is generated, and the
+   project test suite is run on it:
+
+    $ make distcheck
+
+3) Compute checksum of the tarball so that it can be referenced in the release
+   email:
+
+    $ sha256sum ModemManager-${VERSION}.tar.xz
+
+4) Sign release tarball, and verify it (*):
+
+    $ gpg --detach-sign --armor ModemManager-${VERSION}.tar.xz
+    $ gpg --verify ModemManager-${VERSION}.tar.xz.asc ModemManager-${VERSION}.tar.xz
+
+5) Upload source tarball (.tar.xz) and signature (.tar.xz.asc) to
+   freedesktop.org.
+    $ scp ModemManager-${VERSION}.tar.xz* fd.o:${ModemManager}/
+
+6) Create directories for the manpages and gtk-doc documentation in
+   freedesktop.org, and also update the 'latest' links:
+    $ ssh fd.o
+    [fd.o] $ cd ${ModemManager}/man/
+    [fd.o] $ rm latest
+    [fd.o] $ mkdir -p ${VERSION}
+    [fd.o] $ ln -s ${VERSION} latest
+    [fd.o] $ cd ${ModemManager}/doc/
+    [fd.o] $ rm latest
+    [fd.o] $ mkdir -p ${VERSION}/ModemManager
+    [fd.o] $ mkdir -p ${VERSION}/libmm-glib
+    [fd.o] $ ln -s ${VERSION} latest
+
+7) Generate HTML for the manpages:
+    $ roffit < docs/man/mmcli.1 > mmcli.1.html
+    $ roffit < docs/man/ModemManager.8 > ModemManager.8.html
+
+8) Upload manpages in HTML to freedesktop.org:
+    $ scp *.html fd.o:${ModemManager}/man/${VERSION}/
+
+9) Upload the gtk-doc in HTML available inside the source tarball to
+   freedesktop.org. It must be the one inside the tarball because it contains
+   the correct fixed refs to the online documentation of the dependencies
+   (e.g. the glib/gobject/gio documentation URLs in http://developer.gnome.org)
+    $ tar -Jxvf ModemManager-${VERSION}.tar.xz
+    $ scp ModemManager-${VERSION}/docs/reference/api/html/* fd.o:${ModemManager}/doc/${VERSION}/ModemManager/
+    $ scp ModemManager-${VERSION}/docs/reference/libmm-glib/html/* fd.o:${ModemManager}/doc/${VERSION}/libmm-glib/
+
+10.1) For major releases:
+     * Fork new stable branch (e.g. mm-${MAJOR}-${MINOR})
+     * Post-release version bump in the master branch, increment mm_minor_version.
+     * Post-release version bump in the stable branch, increment mm_micro_version.
+
+10.2) For stable branch releases:
+     * Post-release version bump, increment mm_micro_version.
+
+-------------------------------------------------------------------------------
+
+*) Verifying the release signature requires the public key of the person who
+   signed it, e.g.:
+
+    $ curl https://www.freedesktop.org/software/ModemManager/0x3CAD53398973FFFA.asc | gpg --import