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
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
|
# To make real stable releases or devel snapshots, use either:
# make release-check
# or make release-publish
TAR_OPTIONS = --owner=0 --group=0
RELEASE_URL_BASE = http://download.gnome.org/sources/cogl
RELEASE_URL = $(RELEASE_URL_BASE)/$(COGL_1_MAJOR_VERSION).$(COGL_1_MINOR_VERSION)
RELEASE_ANNOUNCE_LIST = cogl@lists.freedesktop.org
RELEASE_ANNOUNCE_CC = gnome-announce-list@gnome.org clutter-announce@clutter-project.org
tar_file = $(distdir).tar.xz
sha256_file = $(distdir).sha256sum
$(sha256_file): $(tar_file)
$(AM_V_GEN)sha256sum $^ > $@
release-tag:
@if test "x$(COGL_RELEASE_STATUS)" = "xgit"; then \
echo "Cannot tag a Git version; please, update the Cogl version" >&2; \
else \
if test -d "$(top_srcdir)/.git"; then \
echo "Tagging release $(COGL_1_VERSION)..." ; \
$(top_srcdir)/build/missing --run git tag \
-s \
-m "Cogl $(COGL_1_VERSION) ($(COGL_RELEASE_STATUS))" \
$(COGL_1_VERSION) ; \
else \
echo A git checkout is required to tag a release >&2; \
fi \
fi
release-check: release-verify-even-micro release-verify-news
TAR_OPTIONS="$(TAR_OPTIONS)" $(MAKE) $(AM_MAKEFLAGS) distcheck
release-verify-news:
@echo -n "Checking that the NEWS file has been updated..."
@if ! grep -q "$(COGL_1_VERSION)" $(top_srcdir)/NEWS; then \
(echo "Ouch." && \
echo "The version in the NEWS file does not match $(COGL_1_VERSION)." && \
echo "This probably means you haven't updated the NEWS file." && \
false); else :; fi
@echo "Good."
release-verify-even-micro:
@echo -n "Checking that $(VERSION) has an even micro component..."
@test "$(COGL_1_MICRO_VERSION)" = "`echo $(COGL_1_MICRO_VERSION)/2*2 | bc`" || \
(echo "Ouch." && \
echo "The version micro component '$(COGL_1_MICRO_VERSION)' is not an even number." && \
echo "The version in configure.ac must be incremented before a new release." && \
false)
@echo "Good."
release-upload: $(sha256_file)
@echo "Uploading to master.gnome.org..."
@scp $(tar_file) master.gnome.org:
@echo "Running ftpadmin install..."
@ssh master.gnome.org ftpadmin install $(tar_file)
@mv -f $(sha256_file) $(top_builddir)/build/$(sha256_file)
@echo "Done."
release-message:
@echo " Release URL: $(RELEASE_URL)/$(tar_file)"
@echo "Release checksum: $(RELEASE_URL)/$(sha256_file)"
@echo "Send an email to: $(RELEASE_ANNOUNCE_LIST)"
@echo " Cc: $(RELEASE_ANNOUNCE_CC)"
@echo " Subject: Release Cogl $(COGL_1_VERSION) ($(COGL_RELEASE_STATUS))"
@echo " Contents:"
@csplit -q --prefix=.README-section- $(top_builddir)/README '/^--$$/' '{*}'
@csplit -q --prefix=.NEWS-section- NEWS '/^Cogl/' '{*}'
@echo "--- CUT HERE ---"
@echo "Good news, everyone!"
@echo ""
@echo "A new Cogl $(COGL_RELEASE_STATUS) ($(COGL_1_VERSION)) is now available:"
@echo ""
@echo "LATEST NEWS"
@echo "-------------------------------------------------------------------------------"
@echo ""
@cat .NEWS-section-01
@echo "FETCHING THE RELEASE"
@echo "-------------------------------------------------------------------------------"
@echo ""
@echo "Tarballs can be downloaded from:"
@echo ""
@echo " http://download.gnome.org/sources/cogl/1.$(COGL_1_MINOR_VERSION)/"
@echo ""
@echo "SHA256 Checksum:"
@echo ""
@cat $(top_builddir)/build/$(sha256_file)
@echo ""
@echo "Additionally, a git clone of the source tree:"
@echo " git clone git://git.gnome.org/cogl"
@echo ""
@echo "will include a signed $(COGL_1_VERSION) tag which points to a commit named:"
@echo " `git cat-file tag $(COGL_1_VERSION) | $(GREP) ^object | $(SED) -e 's,object ,,'`"
@echo ""
@echo "which can be verified with:"
@echo " git verify-tag $(COGL_1_VERSION)"
@echo ""
@echo "and can be checked out with a command such as:"
@echo " git checkout -b build $(COGL_1_VERSION)"
@echo ""
@tail -n +2 .README-section-01
@echo ""
@tail -n +2 .README-section-02
@echo ""
@echo ""
@echo "DOCUMENTATION"
@echo "-------------------------------------------------------------------------------"
@echo ""
@echo "The 1.x stable API is documented here:"
@echo " http://developer.gnome.org/cogl/stable/"
@echo "The 1.x development API is documented here:"
@echo " http://developer.gnome.org/cogl/1.$(COGL_1_MINOR_VERSION)"
@echo "The experimental 2.0 API is documented here:"
@echo " http://cogl3d.org/cogl2-reference/"
@echo ""
@echo ""
@echo "RELEASE NOTES"
@echo "-------------------------------------------------------------------------------"
@if test "x$(COGL_RELEASE_STATUS)" = "xsnapshot"; then \
echo " - This is a development snapshot release so there are not API or ABI stability"; \
echo " guarantees at this point for new APIs since the last stable release."; \
echo ""; \
fi
@echo " - This Cogl release exports a 1.x API (For third-party Clutter"
@echo " developers to write custom actors) and an experimental 2.0 API which"
@echo " allows standalone application development."
@echo ""
@echo " - Internally Clutter depends on the Cogl 2.0 experimental API so we maintain"
@echo " runtime compatibility between the 1.x API and experimental 2.0 APIs, which"
@echo " means developers can mix-and-match their use of the APIs in the same"
@echo " process. API selection is done per-file by including a line like: '#define"
@echo " COGL_ENABLE_EXPERIMENTAL_2_0_API' before including cogl.h or clutter.h."
@echo ""
@echo " - We recommend using the 2.0 API if you don't mind updating your code once in"
@echo " a while as this API evolves and stabilizes. We promise not to break the 2.0"
@echo " API during a 1.x stable cycle and hope that will encourage people to"
@echo " experiment with it and give critical feedback! For example after releasing"
@echo " 1.8, the 2.0 API will be stable for 1.8.1, 1.8.2, 1.8.3 etc, but may update"
@echo " for 1.9/1.10."
@echo ""
@echo " - Because we export the 1.x and 2.0 APIs from one libcogl.so the library"
@echo " versioning, and thus ABI, can only be considered as stable as our 2.0 API - "
@echo " i.e. during a stable release 1.x cycle."
@echo ""
@echo " - Please report bugs using the Cogl Bugzilla product, at:"
@echo " http://bugzilla.gnome.org/enter_bug.cgi?product=cogl"
@echo "--- CUT HERE ---"
release-publish: release-check
$(MAKE) $(AM_MAKEFLAGS) release-tag
$(MAKE) $(AM_MAKEFLAGS) release-upload
$(MAKE) $(AM_MAKEFLAGS) release-message
.PHONY: \
release-check \
release-message \
release-publish \
release-tag \
release-upload \
release-verify-even-micro
|
