aboutsummaryrefslogtreecommitdiffstats
path: root/admin/release-process
diff options
context:
space:
mode:
authorPaul Eggert2016-05-26 12:55:06 -0700
committerPaul Eggert2016-05-26 12:55:06 -0700
commit0bf5739b77c75f13d46fc49d5e3c098fe49a5070 (patch)
treed342da7bc9065197736a8184e55c9925a40f04f0 /admin/release-process
parent764f04871d67a5aad8943136d5142ed59bfa9a51 (diff)
parentc3489d050405ccb026cd44a280ead3a5f6b456d9 (diff)
downloademacs-0bf5739b77c75f13d46fc49d5e3c098fe49a5070.tar.gz
emacs-0bf5739b77c75f13d46fc49d5e3c098fe49a5070.zip
Merge from origin/emacs-25
c3489d0 * lisp/w32-fns.el (set-message-beep, w32-get-locale-info) (w3... a4d882c Correct old cell name unbinding when renaming cell. 6c12c53 Merge branch 'emacs-25' of git.sv.gnu.org:/srv/git/emacs into... 0be6725 Document problem: slow screen refresh on missing font. 853b9b9 * admin/admin.el (add-release-logs): Basic check of existing ... 5fa80cf * build-aux/gitlog-to-emacslog: Handle empty generated Change... 3c79e51 * admin/admin.el (add-release-logs): Generate ChangeLog if ne... 42275df * doc/misc/texinfo.tex: Revert previous change (Bug#23611). 3f4a9d9 * admin/authors.el (authors): First update the ChangeLog. 897fb6f ; 'Changes from the pre-25.1 API' copyedits 825ca25 Rename vc-stay-local back to vc-cvs-stay-local 4efb3e8 * doc/emacs/files.texi (Comparing Files): * doc/emacs/trouble... b995d1e * doc/misc/eww.texi (Advanced): Fix xref. 2e589c0 Fix cross-references between manuals f3d2ded * doc/misc/vhdl-mode.texi (Sample Init File): Rename node to ... 906c810 ; * admin/release-process: Move etc/HISTORY from here... ; * ... bea1b65 * admin/admin.el (add-release-logs): Also update etc/HISTORY. 503e752 ; * CONTRIBUTE: Fix a typo. fbfd478 Avoid aborting due to errors in arguments of 'set-face-attrib... bdfbe6d ; * admin/release-process: Copyedits. 44a6aed ; * test/automated/data-tests.el: Standardize license notice. c33ed39 ; * test/automated/viper-tests.el: Standardize license notice. df4a14b Add automated test for viper-tests.el c0139e3 Fix viper undo breakage from undo-boundary changes 920d76c Fix reference to obsolete fn ps-eval-switch 18a9bc1 Do not trash symlinks to init file 2671179 Don't print the "decomposition" line for control chars in wha... 869092c Bring back xterm pasting with middle mouse 5ab0830 Provide workaround for xftfont rendering problem c9f7ec7 * lisp/desktop.el: Disable restore frameset if in non-graphic... 30989a0 Mention GTK+ problems in etc/PROBLEMS 421e3c4 * lisp/emacs-lisp/package.el (package-refresh-contents): dadfc30 Revert "epg: Add a way to detect gpg1 executable for tests" e41a5cb Avoid errors with Czech and Slovak input methods d4ae6d7 epg: Add a way to detect gpg1 executable for tests ebc3a94 * lisp/emacs-lisp/package.el: Fix free variable warnings. 6e71295 * lisp/emacs-lisp/package.el (package--with-response-buffer): c45d9f6 Improve documentation of 'server-name' 3b5e38c Modernize ASLR advice in etc/PROBLEMS 1fe1e0a * lisp/char-fold.el: Rename from character-fold.el.
Diffstat (limited to 'admin/release-process')
-rw-r--r--admin/release-process61
1 files changed, 32 insertions, 29 deletions
diff --git a/admin/release-process b/admin/release-process
index 2668ea3b445..28f2307846d 100644
--- a/admin/release-process
+++ b/admin/release-process
@@ -7,7 +7,7 @@ Each release cycle will be split into two periods.
7** Phase one: development 7** Phase one: development
8 8
9The first phase of the release schedule is the "heads-down" working 9The first phase of the release schedule is the "heads-down" working
10period for new features, on the 'master' branch and several feature 10period for new features, on the 'master' branch and any needed feature
11branches. 11branches.
12 12
13** Phase two: fixing and stabilizing the release branch 13** Phase two: fixing and stabilizing the release branch
@@ -29,47 +29,60 @@ command to do that, then commit the changes it made and push to
29'master'. For major releases, also update the value of 29'master'. For major releases, also update the value of
30'customize-changed-options-previous-release'. 30'customize-changed-options-previous-release'.
31 31
32The 2 main manuals, the User Manual and the Emacs Lisp Manual, need to 32Each chapter of the two main manuals, the User Manual and the Emacs
33be proofread, preferably by at least 2 different persons, and any 33Lisp Manual, should be proofread, preferably by at least two people.
34uncovered problems fixed. This is a lot of work, so it is advisable 34This job is so big that it should be considered a collective
35to divide the job between several people (see the checklist near the 35responsibility, not fobbed off on just a few people. After each
36end of this file). 36chapter is checked, mark off the name(s) of those who checked it in
37the checklist near the end of this file.
37 38
38In parallel to this phase, 'master' can receive new features, to be 39In parallel to this phase, 'master' can receive new features, to be
39released in the next release cycle. From time to time, the master 40released in the next release cycle. From time to time, the master
40branches merges bugfix commits from the "emacs-NN" branch. 41branches merges bugfix commits from the "emacs-NN" branch.
42See admin/gitmerge.el.
41 43
42* RELEASE-CRITICAL BUGS 44* RELEASE-CRITICAL BUGS
43 45
44Emacs uses the "blocking bug(s)" feature of Debbugs for bugs need to 46Emacs uses the "blocking" feature of Debbugs for bugs that need to be
45be addressed in the next release. 47addressed in the next release.
46 48
47Currently, bug#19759 is the tracking bug for release of 25.1 and 49Currently, bug#19759 is the tracking bug for release of 25.1 and
48bug#21966 is the tracking bug for release of 25.2. Say bug#123 needs 50bug#21966 is the tracking bug for release of 25.2. Say bug#123 needs
51bug#21966 is the tracking bug for the next release. Say bug#123 needs
49to be fixed for Emacs 25.1. Send a message to control@debbugs.gnu.org 52to be fixed for Emacs 25.1. Send a message to control@debbugs.gnu.org
50that says: 53that says:
51 54
52 block 19759 by 123 55 block 19759 by 123
53 56
54Change "block" to "unblock" to unblock the bug. 57Change "block" to "unblock" to remove a bug from the list. Closed
58bugs are not listed as blockers, so you do not need to explicitly
59unblock one that has been closed. You may need to force an update of
60the tracking bug with ctrl-f5/shift-reload to see the latest version.
61
55 62
56* TO BE DONE SHORTLY BEFORE RELEASE 63* TO BE DONE SHORTLY BEFORE RELEASE
57 64
58** Make sure the Copyright date reflects the current year in the source 65See 'admin/make-tarball.txt' for the details of making a release or pretest.
59files. See 'admin/notes/years' for information about maintaining 66
60copyright years for GNU Emacs. 67** Make sure the Copyright date reflects the current year in all source files.
68(This should be done each January anyway, regardless of releases.)
69See admin/update-copyright and admin.el's set-copyright.
70For more details, see 'admin/notes/years'.
61 71
62** Make sure the necessary sources and scripts for any generated files 72** Make sure the necessary sources and scripts for any generated files
63are included in the source tarball. (They don't need to be installed, 73are included in the source tarball. (They don't need to be installed,
64so e.g. admin/ is fine.) 74so e.g. admin/ is fine.) This is important for legal compliance.
65
66** Regenerate AUTHORS by using admin/authors.el
67(The instructions are at the beginning of that file.)
68 75
69** Remove temporary +++/--- lines in NEWS. 76** Remove temporary +++/--- lines in NEWS.
70But first make sure there are no unmarked entries, and update the 77But first make sure there are no unmarked entries, and update the
71documentation (or decide no updates are necessary) for those that 78documentation (or decide no updates are necessary) for those that aren't.
72aren't. 79
80** Try to reorder NEWS: most important things first, related items together.
81
82** For a major release, add a "New in Emacs XX" section to faq.texi.
83
84** cusver-check from admin.el can help find new defcustoms missing
85:version tags.
73 86
74** Manuals 87** Manuals
75Check for node names using problematic characters: 88Check for node names using problematic characters:
@@ -85,8 +98,7 @@ For major releases, rewrite the "Antinews" appendix of the User Manual
85previous version. The way to do that is read NEWS, pick up the more 98previous version. The way to do that is read NEWS, pick up the more
86significant changes and new features in the upcoming release, then 99significant changes and new features in the upcoming release, then
87describe the "benefits" from losing those features. Be funny, use 100describe the "benefits" from losing those features. Be funny, use
88humor. The text written for the previous major release can serve as 101humor. The text written for the previous releases can serve as an example.
89good example.
90 102
91Check cross-references between the manuals (e.g. from emacs to elisp) 103Check cross-references between the manuals (e.g. from emacs to elisp)
92are correct. You can use something like the following in the info 104are correct. You can use something like the following in the info
@@ -147,10 +159,6 @@ size that the GNU Press are going to use when they print the manuals.
147I think this is different to what you get if you just use e.g. 'make 159I think this is different to what you get if you just use e.g. 'make
148emacs.pdf' (e.g., enable "smallbook"). 160emacs.pdf' (e.g., enable "smallbook").
149 161
150** Try to reorder NEWS: most important things first, related items together.
151
152** For a major release, add a "New in Emacs XX" section to faq.texi.
153
154** Check the keybindings in the refcards are correct, and add any new ones. 162** Check the keybindings in the refcards are correct, and add any new ones.
155What paper size are the English versions supposed to be on? 163What paper size are the English versions supposed to be on?
156On Debian testing, the packages texlive-lang-czechslovak and 164On Debian testing, the packages texlive-lang-czechslovak and
@@ -172,11 +180,6 @@ pt-br Rodrigo Real
172ru Alex Ott 180ru Alex Ott
173sk Miroslav Vaško 181sk Miroslav Vaško
174 182
175** cusver-check from admin.el can help find new defcustoms missing
176:version tags.
177
178** Add a line to etc/HISTORY for the release version number and date.
179
180* BUGS 183* BUGS
181 184
182** Check for modes which bind M-s that conflicts with a new global binding M-s 185** Check for modes which bind M-s that conflicts with a new global binding M-s