The libmbim releases are generated using meson.
0.1) For major releases:
* Increment mbim_minor_version and reset mbim_micro_version.
* Assuming API/ABI compatibility, increment both current and age.
0.2) For stable branch releases:
* Increment mbim_micro_version.
1) Add signed tag:
$ git tag -s 1.28.0
The description included in the signed tag could be:
Release 1.28.0
2) Configure and build the whole project, making sure gtk-doc and introspection
are enabled:
$ meson setup build \
--prefix=/usr \
--buildtype=release \
-Dintrospection=true \
-Dgtk_doc=true
$ ninja -C build
3) Run the test suite and install locally:
$ ninja -C build test
$ sudo ninja -C build install
4) Create directories for the manpages and gtk-doc documentation in
freedesktop.org, and also update the 'latest' links:
$ ssh fd.o
[fd.o] $ cd ${libmbim}/man/
[fd.o] $ rm latest
[fd.o] $ mkdir -p ${VERSION}
[fd.o] $ ln -s ${VERSION} latest
[fd.o] $ cd ${libmbim}/libmbim-glib/
[fd.o] $ rm latest
[fd.o] $ mkdir -p ${VERSION}
[fd.o] $ ln -s ${VERSION} latest
5) Generate HTML for the manpages:
$ roffit < build/docs/man/mbimcli.1 > mbimcli.1.html
$ roffit < build/docs/man/mbim-network.1 > mbim-network.1.html
6) Upload manpages in HTML to freedesktop.org:
$ scp *.1.html fd.o:${libmbim}/man/${VERSION}/
7) Copy documentation from /usr/share/gtk-doc and fix online references manually
$ mkdir html
$ cp -r /usr/share/gtk-doc/html/libmbim-glib/* html/
$ for FILE in $(ls html/*.html); do \
sed -i 's|]* href="\.\./glib/[^"]*|