source/libs/cairo/cairo-src/build/Makefile.am.releasing

   1 # Some custom targets to make it easier to release things.
   2 #
   3 # To make real stable releases or devel snapshots, use either:
   4 #               make release-check
   5 # or            make release-publish
   6 #
   7 # To make a quick properly named (date and git hash stamped) tarball:
   8 #               make snapshot
   9
  10
  11 TAR_OPTIONS = --owner=0 --group=0
  12
  13 dist-hook: dist-clear-sticky-bits
  14
  15 # Clean up any sticky bits we may inherit from parent dir
  16 dist-clear-sticky-bits:
  17         chmod -R a-s $(distdir)
  18
  19
  20 snapshot:
  21         distdir="$(distdir)-`date '+%Y%m%d'`"; \
  22         test -d "$(srcdir)/.git" && distdir=$$distdir-`cd "$(srcdir)" && git rev-parse HEAD | cut -c 1-6`; \
  23         TAR_OPTIONS="$(TAR_OPTIONS)" $(MAKE) $(AM_MAKEFLAGS) distdir="$$distdir" snapshot-dist
  24
  25 snapshot-dist: dist
  26         @(echo "$(distdir) archives ready for distribution: "; \
  27           list='$(DIST_ARCHIVES)'; for i in $$list; do echo $$i; done) | \
  28           sed -e 1h -e 1s/./=/g -e 1p -e 1x -e '$$p' -e '$$x'
  29
  30 RELEASE_OR_SNAPSHOT = $$(if test "x$(CAIRO_VERSION_MINOR)" = "x$$(echo "$(CAIRO_VERSION_MINOR)/2*2" | bc)" ; then echo release; else echo snapshot; fi)
  31 RELEASE_UPLOAD_HOST =   cairographics.org
  32 RELEASE_UPLOAD_BASE =   /srv/cairo.freedesktop.org/www
  33 RELEASE_UPLOAD_DIR =    $(RELEASE_UPLOAD_BASE)/$(RELEASE_OR_SNAPSHOT)s
  34 RELEASE_URL_BASE =      http://cairographics.org/$(RELEASE_OR_SNAPSHOT)s
  35 RELEASE_ANNOUNCE_LIST = cairo-announce@cairographics.org (and CC gnome-announce-list@gnome.org)
  36
  37 MANUAL_VERSIONED =              manual-$(VERSION)
  38 MANUAL_TAR_FILE =               $(MANUAL_VERSIONED).tar.gz
  39 MANUAL_UPLOAD_DIR =             $(RELEASE_UPLOAD_BASE)
  40
  41 tar_file = $(PACKAGE)-$(VERSION).tar.xz
  42 sha1_file = $(tar_file).sha1
  43 gpg_file = $(sha1_file).asc
  44
  45 $(sha1_file): $(tar_file)
  46         sha1sum $^ > $@
  47
  48 $(gpg_file): $(sha1_file)
  49         @echo "Please enter your GPG password to sign the checksum."
  50         gpg --armor --sign $^
  51
  52 release-verify-sane-changelogs: changelogs
  53         @echo -n "Checking that the ChangeLog files are sane..."
  54         @if grep -q "is required to generate" $(CHANGELOGS); then \
  55                 (echo "Ouch." && echo "Some of the ChangeLogs are not generated correctly." \
  56                 && echo "Remove ChangeLog* and make changelogs" \
  57                 && false); else :; fi
  58         @echo "Good."
  59
  60 release-verify-sane-tests:
  61         @echo "Checking that the test suite is sane..."
  62         @cd test && $(MAKE) $(AM_MAKEFLAGS) release-verify-sane-tests
  63
  64 release-verify-even-micro:
  65         @echo -n "Checking that $(VERSION) has an even micro component..."
  66         @test "$(CAIRO_VERSION_MICRO)" = "`echo $(CAIRO_VERSION_MICRO)/2*2 | bc`" \
  67                 || (echo "Ouch." && echo "The version micro component '$(CAIRO_VERSION_MICRO)' is not an even number." \
  68                 && echo "The version in configure.in must be incremented before a new release." \
  69                 && false)
  70         @echo "Good."
  71
  72 release-verify-newer:
  73         @echo -n "Checking that no $(VERSION) release already exists..."
  74         @ssh $(RELEASE_UPLOAD_HOST) test ! -e $(RELEASE_UPLOAD_DIR)/$(tar_file) \
  75                 || (echo "Ouch." && echo "Found: $(RELEASE_UPLOAD_HOST):$(RELEASE_UPLOAD_DIR)/$(tar_file)" \
  76                 && echo "Are you sure you have an updated checkout?" \
  77                 && echo "This should never happen." \
  78                 && false)
  79         @echo "Good."
  80
  81 release-remove-old:
  82         $(RM) $(tar_file) $(sha1_file) $(gpg_file)
  83
  84
  85 # Strict ordering enforced for parallel make to work
  86 release-check: \
  87         release-verify-even-micro \
  88         release-verify-sane-changelogs \
  89         release-verify-sane-tests \
  90         release-verify-newer \
  91         $(NULL)
  92         $(MAKE) $(AM_MAKEFLAGS) release-remove-old
  93         TAR_OPTIONS="$(TAR_OPTIONS)" $(MAKE) $(AM_MAKEFLAGS) distcheck
  94
  95 release-upload: $(tar_file) $(sha1_file) $(gpg_file)
  96         mkdir -p releases
  97         scp $(tar_file) $(sha1_file) $(gpg_file) $(RELEASE_UPLOAD_HOST):$(RELEASE_UPLOAD_DIR)
  98         mv $(tar_file) $(sha1_file) $(gpg_file) releases
  99         ssh $(RELEASE_UPLOAD_HOST) "rm -f $(RELEASE_UPLOAD_DIR)/LATEST-$(PACKAGE)-[0-9]* && ln -s $(tar_file) $(RELEASE_UPLOAD_DIR)/LATEST-$(PACKAGE)-$(VERSION)"
 100         git tag -s  -m "cairo $(CAIRO_VERSION_MAJOR).$(CAIRO_VERSION_MINOR).$(CAIRO_VERSION_MICRO) release" $(CAIRO_VERSION_MAJOR).$(CAIRO_VERSION_MINOR).$(CAIRO_VERSION_MICRO)
 101
 102 release-publish-message: releases/$(sha1_file)
 103         @echo "Please follow the instructions in RELEASING to push stuff out and"
 104         @echo "send out the announcement mails.  Here is the excerpt you need:"
 105         @echo ""
 106         @echo "Subject: $(PACKAGE) $(RELEASE_OR_SNAPSHOT) $(VERSION) now available"
 107         @echo ""
 108         @echo "============================== CUT HERE =============================="
 109         @echo "A new $(PACKAGE) $(RELEASE_OR_SNAPSHOT) $(VERSION) is now available from:"
 110         @echo ""
 111         @echo " $(RELEASE_URL_BASE)/$(tar_file)"
 112         @echo ""
 113         @echo "    which can be verified with:"
 114         @echo ""
 115         @echo " $(RELEASE_URL_BASE)/$(sha1_file)"
 116         @echo -n "      "
 117         @cat releases/$(sha1_file)
 118         @echo ""
 119         @echo " $(RELEASE_URL_BASE)/$(gpg_file)"
 120         @echo " (signed by `getent passwd "$$USER" | cut -d: -f 5 | cut -d, -f 1`)"
 121         @echo ""
 122         @echo "  Additionally, a git clone of the source tree:"
 123         @echo ""
 124         @echo " git clone git://git.cairographics.org/git/cairo"
 125         @echo ""
 126         @echo "    will include a signed $(VERSION) tag which points to a commit named:"
 127         @echo " `git cat-file tag $(VERSION) | grep ^object | sed -e 's,object ,,'`"
 128         @echo ""
 129         @echo "    which can be verified with:"
 130         @echo " git verify-tag $(VERSION)"
 131         @echo ""
 132         @echo "    and can be checked out with a command such as:"
 133         @echo " git checkout -b build $(VERSION)"
 134         @echo ""
 135         @echo "============================== CUT HERE =============================="
 136
 137 doc-publish-versioned: doc
 138         rm -rf ./$(MANUAL_VERSIONED)
 139         cp -a doc/public/html $(MANUAL_VERSIONED)
 140         tar czf $(MANUAL_TAR_FILE) $(MANUAL_VERSIONED)
 141         scp $(MANUAL_TAR_FILE) $(RELEASE_UPLOAD_HOST):$(MANUAL_UPLOAD_DIR)
 142         ssh $(RELEASE_UPLOAD_HOST) "cd $(MANUAL_UPLOAD_DIR) && tar xzf $(MANUAL_TAR_FILE) && ln -sf $(MANUAL_TAR_FILE) cairo-$(MANUAL_TAR_FILE)"
 143
 144 doc-publish-symlinks:
 145         ssh $(RELEASE_UPLOAD_HOST) "cd $(MANUAL_UPLOAD_DIR) && rm -f manual && ln -s $(MANUAL_VERSIONED) manual && ln -sf $(MANUAL_TAR_FILE) cairo-manual.tar.gz"
 146
 147 doc-publish:
 148         $(MAKE) $(AM_MAKEFLAGS) doc-publish-versioned
 149         @if test "$(RELEASE_OR_SNAPSHOT)" = release; then $(MAKE) $(AM_MAKEFLAGS) doc-publish-symlinks; fi
 150
 151 # Strict ordering enforced for parallel make to work
 152 release-publish: release-check
 153         $(MAKE) $(AM_MAKEFLAGS) release-upload
 154         $(MAKE) $(AM_MAKEFLAGS) doc-publish
 155         $(MAKE) $(AM_MAKEFLAGS) release-publish-message
 156
 157 if OS_WIN32
 158
 159 # Win32 package zipfiles
 160 runtime_zip_file = $(PACKAGE)-$(VERSION).zip
 161 developer_zip_file = $(PACKAGE)-dev-$(VERSION).zip
 162
 163 $(runtime_zip_file): install
 164         -$(RM) $@
 165         pwd=`pwd`; cd $(prefix); \
 166         zip "$$pwd"/$@ bin/libcairo-$(CAIRO_VERSION_SONUM).dll
 167
 168 $(developer_zip_file): install
 169         -$(RM) $@
 170         pwd=`pwd`; cd $(prefix); \
 171         zip -r "$$pwd"/$@ include/cairo lib/libcairo.dll.a lib/cairo.lib lib/pkgconfig/cairo.pc lib/pkgconfig/cairo-*.pc share/gtk-doc/html/cairo
 172
 173 zips: $(runtime_zip_file) $(developer_zip_file)
 174
 175 endif
 176
 177
 178 .PHONY: \
 179         dist-clear-sticky-bits \
 180         doc-publish \
 181         doc-publish-symlinks \
 182         doc-publish-versioned \
 183         release-check \
 184         release-publish \
 185         release-publish-message \
 186         release-remove-old \
 187         release-upload \
 188         release-verify-even-micro \
 189         release-verify-newer \
 190         release-verify-sane-changelogs \
 191         release-verify-sane-tests \
 192         snapshot \
 193         snapshot-dist \
 194         $(NULL)