From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 6789 invoked by alias); 3 Sep 2018 17:55:01 -0000 Mailing-List: contact zsh-workers-help@zsh.org; run by ezmlm Precedence: bulk X-No-Archive: yes List-Id: Zsh Workers List List-Post: List-Help: List-Unsubscribe: X-Seq: 43370 Received: (qmail 15445 invoked by uid 1010); 3 Sep 2018 17:55:01 -0000 X-Qmail-Scanner-Diagnostics: from out1-smtp.messagingengine.com by f.primenet.com.au (envelope-from , uid 7791) with qmail-scanner-2.11 (clamdscan: 0.99.2/21882. spamassassin: 3.4.1. Clear:RC:0(66.111.4.25):SA:0(-2.6/5.0):. Processed in 2.657979 secs); 03 Sep 2018 17:55:01 -0000 X-Spam-Checker-Version: SpamAssassin 3.4.1 (2015-04-28) on f.primenet.com.au X-Spam-Level: X-Spam-Status: No, score=-2.6 required=5.0 tests=BAYES_00,RCVD_IN_DNSWL_LOW, SPF_HELO_PASS,T_DKIM_INVALID autolearn=ham autolearn_force=no version=3.4.1 X-Envelope-From: d.s@daniel.shahaf.name X-Qmail-Scanner-Mime-Attachments: | X-Qmail-Scanner-Zip-Files: | DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= daniel.shahaf.name; h=date:from:message-id:subject:to :x-me-sender:x-me-sender:x-sasl-enc; s=fm1; bh=lBsCKAj3h8MdzqvQN vploaD9vTuRZUVq0LVNJl7DZYE=; b=JAkjLJB+Frnb17AzbwSmHST8+CtLw6Tqm CrTlLHBpJq/eWM5lccfpBUokIvcrROtJe8KVo+aKl5sQbLQZPQPdM7IMtPJsv82l zNjQSlkWLKw0DDA/+XTjGSWbD6rCg3rH2QGY1ykauF7dkkNkefN2GKOdblekeb4k Y1eCw8zafQ3+Do47z5URCGGFtc3AvGQvavVD061xscO7+mxOgDgPUH1z7TNV4ctS jptG49KG7wRHL9nno2An2lbxD7q8e2QiFJnIERFNA3DbXIf/BeFmhJkhgW87hfS1 xqeHNoz/Vv7dQEeEDzkdJeml8Yhl799ZNccjctloxgTdYsl5+Razw== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=date:from:message-id:subject:to :x-me-sender:x-me-sender:x-sasl-enc; s=fm3; bh=lBsCKAj3h8MdzqvQN vploaD9vTuRZUVq0LVNJl7DZYE=; b=c/gbjcnZ4rRQja9ph2aB3wfL9pTw+C3g2 T9sKfA2AB3nP/CxZCM447X1SCDBi7vT9FZlWHedjF3/U3FIWnEBTcn4aWade2I50 r/oGze7274IETCE+63WUcrLK0iUUvenVcUPKzXlCbyGNXbqtky7l2V81T98di0Zd xVs686DPHFVAsL9yrdPHs1X/L9o00UfqjJDvjpcki3QoFBT05VRHBwUxO0MWD9y+ Ulv0m3BfscSJVbczptJazHYUrkUBo8I/zNcuZBaHW6KlXBadCZixZjbbHOD4omAj rc+BV8i/O98S4BA7Y0drugWCOZ4lyu8lKPHQYEBdEx1SYN7vpskEQ== X-ME-Proxy: X-ME-Sender: From: Daniel Shahaf To: zsh-workers@zsh.org Subject: [PATCH] New maintainer-facing documentation. Date: Mon, 3 Sep 2018 17:54:50 +0000 Message-Id: <20180903175450.30043-1-danielsh@tarpaulin.shahaf.local2> X-Mailer: git-send-email 2.11.0 --- Etc/creating-a-release.txt | 60 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 60 insertions(+) create mode 100644 Etc/creating-a-release.txt diff --git a/Etc/creating-a-release.txt b/Etc/creating-a-release.txt new file mode 100644 index 000000000..5d4e1e8b2 --- /dev/null +++ b/Etc/creating-a-release.txt @@ -0,0 +1,60 @@ +To create a zsh release: + +- Be satisfied that 'master' is releaseable. + (No recent destabilizing changes, `make check` passes, etc) + +- Bump or update: + + Config/version.mk to today's date + Config/version.mk version number (sequence: 5.4.2, 5.4.2-dev-$((i++)), 5.4.2-test-$((++j)), 5.5) + Etc/FAQ.yo + README + NEWS + +- Commit those changes with an "unposted" ChangeLog entry. + + git commit -am "Test release: 5.5.1-test-1." && + zshdev-add-nnnnn-and-changelog unposted + # (Everyone has a different way of getting the "unposted" magic string + # into ChangeLog and the log message. This script is how I do it; YMMV; + # see Etc/zsh-development-guide for alternative scripts.) + +- Create signed git tag named "zsh-5.5.1-..." (not "5.5.1-...") + + git tag --sign -m "Tag version zsh-5.5.1-test-1." zsh-5.5.1-test-1 + +- If the tagged release is a stable release (as opposed to a test release): + + vi Config/version.mk # bump to 5.6-dev-0 and tomorrow's date + git commit -am "Post-release version bump." && + zshdev-add-nnnnn-and-changelog unposted + # or local equivalent (see above) + +- Create tarball: + + git checkout zsh-5.5.1-test-1 + make -C Etc + make -C Doc everything + make tarxz-doc tarxz-src + for i in zsh*.tar.?z ; do gpg -ab -- $i ; done + + # The tarxz-* targets create both *.tar.gz and *.tar.xz. + +- [one time step] Add your key to http://zsh.sf.net/Arc/source.html; see README in the 'web' repository for how to do this. Its URL is: + + git clone git://git.code.sf.net/p/zsh/web + git clone ssh://git.code.sf.net/p/zsh/web + +- Upload to sf.net + + Test releases go to the "zsh-test" directory. + Stable releases to zsh/ and zsh-doc/. + +- Upload to zsh.org + +- Post to -workers@ + +- After a day or so post to: + + -users@, if test release; + -announce@, if stable release.