blob: 94bfdd0d80a21599d335aa14b446cc6d57261af7 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
|
The libqmi releases are generated using meson.
0.1) For major releases:
* Increment qmi_minor_version and reset qmi_micro_version.
* Assuming API/ABI compatibility, increment both current and age.
0.2) For stable branch releases:
* Increment qmi_micro_version.
1) Add signed tag:
$ git tag -s 1.32.0
The description included in the signed tag could be:
Release 1.32.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 ${libqmi}/man/
[fd.o] $ rm latest
[fd.o] $ mkdir -p ${VERSION}
[fd.o] $ ln -s ${VERSION} latest
[fd.o] $ cd ${libqmi}/libqmi-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/qmicli.1 > qmicli.1.html
$ roffit < build/docs/man/qmi-network.1 > qmi-network.1.html
$ roffit < build/docs/man/qmi-firmware-update.1 > qmi-firmware-update.1.html
6) Upload manpages in HTML to freedesktop.org:
$ scp *.1.html fd.o:${libqmi}/man/${VERSION}/
7) Copy documentation from /usr/share/gtk-doc and fix online references manually
$ mkdir html
$ cp -r /usr/share/gtk-doc/html/libqmi-glib/* html/
$ for FILE in $(ls html/*.html); do \
sed -i 's|<a[^>]* href="\.\./glib/[^"]*|<a href="https://docs.gtk.org/glib/|g' $FILE; \
sed -i 's|<a[^>]* href="\.\./gobject/[^"]*|<a href="https://docs.gtk.org/gobject/|g' $FILE; \
sed -i 's|<a[^>]* href="\.\./gio/[^"]*|<a href="https://docs.gtk.org/gio/|g' $FILE; \
done
8) Upload the modified HTML files to freedesktop.org:
$ scp html/* fd.o:${libqmi}/libqmi-glib/${VERSION}/
10.1) For major releases:
* Fork new stable branch (e.g. qmi-${MAJOR}-${MINOR})
* Post-release version bump in the main branch, increment qmi_minor_version.
* Post-release version bump in the stable branch, increment qmi_micro_version.
10.2) For stable branch releases:
* Post-release version bump, increment qmi_micro_version.
-------------------------------------------------------------------------------
*) Verifying the release signature requires the public key of the person who
signed it, e.g.:
$ curl https://www.freedesktop.org/software/libqmi/0xAECE0239C6606AD5.asc | gpg --import
|
