changeset 103854:09fe9897acab

Comments on manual checking.
author Glenn Morris <rgm@gnu.org>
date Sat, 11 Jul 2009 03:06:44 +0000
parents f2f11372ba48
children 6479d8a2ebcf
files admin/FOR-RELEASE
diffstat 1 files changed, 22 insertions(+), 2 deletions(-) [+]
line wrap: on
line diff
--- a/admin/FOR-RELEASE	Sat Jul 11 03:02:18 2009 +0000
+++ b/admin/FOR-RELEASE	Sat Jul 11 03:06:44 2009 +0000
@@ -2,8 +2,26 @@
 
 * 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 @@
 
 ** 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?