Mercurial > masqmail
annotate docs/howto-release @ 421:f37384470855
Changed lockdir to /var/lock/masqmail; Create lockdir and piddir on startup.
Moved the lockdir out of the spool dir. (When /var/lock is a ramdisk
we do well to have the lock files there.) Added the new configure option
--with-lockdir to change that location. Nontheless, if we run_as_user,
then lock files are always stored in the spool dir directly.
Instead of installing the lockdir and piddir at installation time, we
create them on startup time now if they are missing. This is necessary
if lockdir or piddir are a tmpfs.
author | markus schnalke <meillo@marmaro.de> |
---|---|
date | Wed, 30 May 2012 09:38:38 +0200 |
parents | 2c3242a360f0 |
children | f2a7271746d1 |
rev | line source |
---|---|
297
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
1 How to do a masqmail release |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
2 ============================ |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
3 meillo 2010-12-09 |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
4 |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
5 |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
6 This document helps me to not forget any steps and to document how I |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
7 did it for any new maintainer who might come after me. This document |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
8 was inspired by docs/README.developers of the nmh project. |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
9 |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
10 |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
11 (1) Be sure that the current state of the project is ready to |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
12 release. Test if it compiles. Test if it works (this should be done |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
13 automatically with a better test suite). |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
14 |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
15 (2) Update ChangeLog and NEWS based on the VCS log. Don't forget to |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
16 update the time of the ChangeLog entry. Check if contributions from |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
17 others are acknowledged adequately (ChangeLog, THANKS). |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
18 |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
19 (3) Remove the -dev suffix from the version number in configure.ac. Run |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
20 autoconf afterwards to transfer the change to the configure script. Build |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
21 masqmail and run it with -bV to check the version. |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
22 |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
23 (4) Run devel/list-versions and devel/update-manpage-date afterwards to |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
24 have the right version and date in the man pages. |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
25 |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
26 (5) Is everything checked in? |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
27 |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
28 (6) Run `make distclean', check for remaining files (just in case). `hg |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
29 st' is helpful. Build anew: `./configure ... && make && sudo make |
334 | 30 install'. Check if everything went well. If so, `make distclean' again. |
297
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
31 |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
32 |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
33 Now we should be ready to release. |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
34 |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
35 |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
36 (7) Run `devel/gen-release ../masqmail-0.x.y.tar.gz'. An md5sum will |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
37 be generated automatically and a detached gpg signature will be created |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
38 (this requires gnupg with a secret key). |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
39 |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
40 (8) Unpack the generated tarball and examine its contents (-t or |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
41 -xv). Build masqmail anew from the tarball, see (6). |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
42 |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
43 (9) Check the md5sum and the signature. |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
44 |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
45 |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
46 Let's release. |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
47 |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
48 |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
49 (10) Upload the tarball, the md5sum and the signature to the website. |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
50 |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
51 (11) Write a release announcement to the mailing list. Preferably, the |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
52 announcement should contain the MD5 hash generated above, and should be |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
53 PGP-signed. It should include the URL for the tarball as well as the URL |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
54 of the website. It should contain a brief summary of visible changes, as |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
55 well as the URL of the webpage that would show a detailed list of changes. |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
56 |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
57 (12) Submit a release info to freshmeat.net. |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
58 |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
59 (13) Add a version tag to the VCS. |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
60 |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
61 (14) Change the version number in configure.ac: Increment it and add |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
62 -dev to it. Run autoconf afterwards to propagate the change. |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
63 |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
64 |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
65 Done. |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
66 |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
67 |
b639e97feda3
added a description of how I create a masqmail release
markus schnalke <meillo@marmaro.de>
parents:
diff
changeset
|
68 Enjoy the day. :-) |