summaryrefslogtreecommitdiff
path: root/admin
diff options
context:
space:
mode:
authorGlenn Morris <rgm@gnu.org>2009-07-11 03:06:44 +0000
committerGlenn Morris <rgm@gnu.org>2009-07-11 03:06:44 +0000
commit10a99e0de5c2d746a97c59d84bb2f8abccc73689 (patch)
tree492d85b8fc87b8f25b6aef0bde4f8cc34728e06d /admin
parente538d47927c04b683dba8c7eaa83fbb18feb0a88 (diff)
downloademacs-10a99e0de5c2d746a97c59d84bb2f8abccc73689.tar.gz
Comments on manual checking.
Diffstat (limited to 'admin')
-rw-r--r--admin/FOR-RELEASE24
1 files changed, 22 insertions, 2 deletions
diff --git a/admin/FOR-RELEASE b/admin/FOR-RELEASE
index 28c21d88b0e..ee31f98f1c2 100644
--- a/admin/FOR-RELEASE
+++ b/admin/FOR-RELEASE
@@ -2,8 +2,26 @@ Tasks needed before the next release.
* TO BE DONE SHORTLY BEFORE RELEASE
-** Check for widow and orphan lines in manuals;
-make sure all the pages really look ok in the manual as formatted.
+** Manuals
+Check cross-references between the manuals (eg from emacs to elisp)
+are correct. (Is there an automated way to do this?)
+
+make emacs.dvi, elisp.dvi, and deal with any errors (undefined
+references etc) in the output. Break any overfull lines.
+Underfull hboxes are not serious, but it can be nice to get rid of
+them if a simple rephrasing or rearrangement will work.
+
+Update the master menu and detailed menu (eg the antinews version).
+The command texinfo-multiple-files-update can do this, but you
+probably want to apply the results selectively (eg the current master
+menu has better line-breaks than the automatic version). It includes
+the menu-entry name (if there is one) as well as the node name - using
+only the latter looks better. Also, it doesn't seem to handle nested
+includes, so will miss edebug.texi etc.
+
+Check for widow and orphan lines; make sure all the pages really look
+ok in the manual as formatted. (AFAIK, there is no way to do this
+except paging through the whole manual.)
** Regenerate the pdf versions of the reference cards in etc/refcards/.
@@ -24,6 +42,8 @@ sk Miroslav Vaško
** Try to reorder NEWS: most important things first, related items together.
+** Consider bumping customize-changed-options-previous-release.
+
* BUGS
** Does deleting frames run Lisp code? If so, can we get rid of that?