[Emacs-diffs] emacs/admin FOR-RELEASE

[Glenn Morris]

CVSROOT:        /sources/emacs
Module name:    emacs
Changes by:     Glenn Morris <gm>       09/07/11 03:06:45

Modified files:
        admin          : FOR-RELEASE 

Log message:
        Comments on manual checking.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/emacs/admin/FOR-RELEASE?cvsroot=emacs&r1=1.892&r2=1.893

Patches:
Index: FOR-RELEASE
===================================================================
RCS file: /sources/emacs/emacs/admin/FOR-RELEASE,v
retrieving revision 1.892
retrieving revision 1.893
diff -u -b -r1.892 -r1.893
--- FOR-RELEASE 8 Jul 2009 02:38:11 -0000       1.892
+++ FOR-RELEASE 11 Jul 2009 03:06:44 -0000      1.893
@@ -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?