aboutsummaryrefslogtreecommitdiffstats
path: root/admin/release-process
diff options
context:
space:
mode:
authorStefan Kangas2025-01-24 01:40:55 +0100
committerStefan Kangas2025-01-24 01:40:55 +0100
commit4ed4792e3b9f77a504925ca46b2181b5e823556b (patch)
treefc14f7af903f46b6f2bbf88ccb99585a5d12d455 /admin/release-process
parent4a867c823b77fc77be57f13d355fe9469281d653 (diff)
downloademacs-4ed4792e3b9f77a504925ca46b2181b5e823556b.tar.gz
emacs-4ed4792e3b9f77a504925ca46b2181b5e823556b.zip
; * admin/release-process: Minor copy-edits.
Diffstat (limited to 'admin/release-process')
-rw-r--r--admin/release-process15
1 files changed, 6 insertions, 9 deletions
diff --git a/admin/release-process b/admin/release-process
index d66bc48f70d..b76a6aa4ec8 100644
--- a/admin/release-process
+++ b/admin/release-process
@@ -90,7 +90,8 @@ documentation (or decide no updates are necessary) for those that aren't.
90 90
91** Try to reorder NEWS: most important things first, related items together. 91** Try to reorder NEWS: most important things first, related items together.
92 92
93** For a major release, add a "New in Emacs XX" section to faq.texi. 93** For a major release, add a "New in Emacs XX" section to efaq.texi.
94This should highlight some of the more significant changes.
94 95
95** cusver-check from admin.el can help find new defcustoms missing 96** cusver-check from admin.el can help find new defcustoms missing
96:version tags. This asks for new and old Lisp directories; use the one 97:version tags. This asks for new and old Lisp directories; use the one
@@ -113,14 +114,14 @@ Check for node names using problematic characters:
113Sadly makeinfo does not warn about such characters. 114Sadly makeinfo does not warn about such characters.
114 115
115Check for major new features added since the last release (e.g. new 116Check for major new features added since the last release (e.g. new
116lisp files), and add the relevant authors to the Acknowledgments in 117Lisp files), and add the relevant authors to the Acknowledgments in
117doc/emacs/ack.texi and emacs.texi. To find new files, you could run a 118doc/emacs/ack.texi and emacs.texi. To find new files, you could run a
118command such as this: 119command such as this:
119 120
120 $ diff -rq emacs-NN.MM emacs-XX.YY | grep "^Only in emacs-XX" 121 $ git diff --name-status emacs-NN emacs-XX | grep -E "^A"
121 122
122where NN.MM is the previous Emacs version, and XX.YY is the new version. 123where emacs-NN is the previous Emacs release branch, and emacs-XX is the
123This assumes you have the source trees of both versions available. 124new one.
124 125
125For major releases, rewrite the "Antinews" appendix of the User Manual 126For major releases, rewrite the "Antinews" appendix of the User Manual
126(doc/emacs/anti.texi) to describe features lost by downgrading to the 127(doc/emacs/anti.texi) to describe features lost by downgrading to the
@@ -129,10 +130,6 @@ significant changes and new features in the upcoming release, then
129describe the "benefits" from losing those features. Be funny, use 130describe the "benefits" from losing those features. Be funny, use
130humor. The text written for the previous releases can serve as an example. 131humor. The text written for the previous releases can serve as an example.
131 132
132The Emacs FAQ (doc/misc/efaq.texi) also has a "What's new" section;
133for major releases a new section should be added listing the
134significant changes.
135
136Check cross-references between the manuals (e.g. from emacs to elisp) 133Check cross-references between the manuals (e.g. from emacs to elisp)
137are correct. You can use something like the following in the info 134are correct. You can use something like the following in the info
138directory in the Emacs build tree: 135directory in the Emacs build tree: