; Update instructions about ChangeLog.N file generation

* admin/make-tarball.txt: Add instructions about rotating and
regenerating the versioned ChangeLog.N file.
This commit is contained in:
Eli Zaretskii 2022-04-22 09:26:10 +03:00
parent d5728f129f
commit 43ed7b1e0f

View file

@ -54,12 +54,31 @@ General steps (for each step, check for possible errors):
section at the beginning of that file, and commit etc/NEWS if it
was modified.
2. Regenerate the etc/AUTHORS file:
2. Regenerate the versioned ChangeLog.N and etc/AUTHORS files.
The "M-x authors" command below will first update the current
versioned ChangeLog.N file. For this to work correctly, make sure
the top-level Makefile says
PREFERRED_BRANCH = emacs-NN
where NN is the version on the release branch from which you are
producing the tarball. If NN is incorrect, update Makefile.in and
re-run 'configure' to update Makefile.
If the versioned ChangeLog.N file is too large, start a new one
by bumping N, and also update the line in top-level Makefile.in
which says
CHANGELOG_HISTORY_INDEX_MAX = N
by incrementing the value of N by 1; then regenerate Makefile.
Now:
M-: (require 'authors) RET
M-x authors RET
(This first updates the current versioned ChangeLog.N)
If this says "Problem updating ChangeLog", find the reason for the
failure of the command it runs, viz.: