[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
emacs-30 4ed4792e3b9 1/2: ; * admin/release-process: Minor copy-edits.
From: |
Stefan Kangas |
Subject: |
emacs-30 4ed4792e3b9 1/2: ; * admin/release-process: Minor copy-edits. |
Date: |
Thu, 23 Jan 2025 19:56:45 -0500 (EST) |
branch: emacs-30
commit 4ed4792e3b9f77a504925ca46b2181b5e823556b
Author: Stefan Kangas <stefankangas@gmail.com>
Commit: Stefan Kangas <stefankangas@gmail.com>
; * admin/release-process: Minor copy-edits.
---
admin/release-process | 15 ++++++---------
1 file 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.
** Try to reorder NEWS: most important things first, related items together.
-** For a major release, add a "New in Emacs XX" section to faq.texi.
+** For a major release, add a "New in Emacs XX" section to efaq.texi.
+This should highlight some of the more significant changes.
** cusver-check from admin.el can help find new defcustoms missing
:version tags. This asks for new and old Lisp directories; use the one
@@ -113,14 +114,14 @@ Check for node names using problematic characters:
Sadly makeinfo does not warn about such characters.
Check for major new features added since the last release (e.g. new
-lisp files), and add the relevant authors to the Acknowledgments in
+Lisp files), and add the relevant authors to the Acknowledgments in
doc/emacs/ack.texi and emacs.texi. To find new files, you could run a
command such as this:
- $ diff -rq emacs-NN.MM emacs-XX.YY | grep "^Only in emacs-XX"
+ $ git diff --name-status emacs-NN emacs-XX | grep -E "^A"
-where NN.MM is the previous Emacs version, and XX.YY is the new version.
-This assumes you have the source trees of both versions available.
+where emacs-NN is the previous Emacs release branch, and emacs-XX is the
+new one.
For major releases, rewrite the "Antinews" appendix of the User Manual
(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
describe the "benefits" from losing those features. Be funny, use
humor. The text written for the previous releases can serve as an example.
-The Emacs FAQ (doc/misc/efaq.texi) also has a "What's new" section;
-for major releases a new section should be added listing the
-significant changes.
-
Check cross-references between the manuals (e.g. from emacs to elisp)
are correct. You can use something like the following in the info
directory in the Emacs build tree: