diff options
| author | Stefan Kangas | 2025-01-24 01:40:55 +0100 |
|---|---|---|
| committer | Stefan Kangas | 2025-01-24 01:40:55 +0100 |
| commit | 4ed4792e3b9f77a504925ca46b2181b5e823556b (patch) | |
| tree | fc14f7af903f46b6f2bbf88ccb99585a5d12d455 /admin/release-process | |
| parent | 4a867c823b77fc77be57f13d355fe9469281d653 (diff) | |
| download | emacs-4ed4792e3b9f77a504925ca46b2181b5e823556b.tar.gz emacs-4ed4792e3b9f77a504925ca46b2181b5e823556b.zip | |
; * admin/release-process: Minor copy-edits.
Diffstat (limited to 'admin/release-process')
| -rw-r--r-- | admin/release-process | 15 |
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. |
| 94 | This 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: | |||
| 113 | Sadly makeinfo does not warn about such characters. | 114 | Sadly makeinfo does not warn about such characters. |
| 114 | 115 | ||
| 115 | Check for major new features added since the last release (e.g. new | 116 | Check for major new features added since the last release (e.g. new |
| 116 | lisp files), and add the relevant authors to the Acknowledgments in | 117 | Lisp files), and add the relevant authors to the Acknowledgments in |
| 117 | doc/emacs/ack.texi and emacs.texi. To find new files, you could run a | 118 | doc/emacs/ack.texi and emacs.texi. To find new files, you could run a |
| 118 | command such as this: | 119 | command 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 | ||
| 122 | where NN.MM is the previous Emacs version, and XX.YY is the new version. | 123 | where emacs-NN is the previous Emacs release branch, and emacs-XX is the |
| 123 | This assumes you have the source trees of both versions available. | 124 | new one. |
| 124 | 125 | ||
| 125 | For major releases, rewrite the "Antinews" appendix of the User Manual | 126 | For 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 | |||
| 129 | describe the "benefits" from losing those features. Be funny, use | 130 | describe the "benefits" from losing those features. Be funny, use |
| 130 | humor. The text written for the previous releases can serve as an example. | 131 | humor. The text written for the previous releases can serve as an example. |
| 131 | 132 | ||
| 132 | The Emacs FAQ (doc/misc/efaq.texi) also has a "What's new" section; | ||
| 133 | for major releases a new section should be added listing the | ||
| 134 | significant changes. | ||
| 135 | |||
| 136 | Check cross-references between the manuals (e.g. from emacs to elisp) | 133 | Check cross-references between the manuals (e.g. from emacs to elisp) |
| 137 | are correct. You can use something like the following in the info | 134 | are correct. You can use something like the following in the info |
| 138 | directory in the Emacs build tree: | 135 | directory in the Emacs build tree: |