| |
| |
| 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 main 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 |