* xterm.c: Fix problems found by static analysis with other toolkits.
[bpt/emacs.git] / admin / FOR-RELEASE
index ee31f98..4533026 100644 (file)
@@ -4,7 +4,11 @@ Tasks needed before the next release.
 
 ** Manuals
 Check cross-references between the manuals (eg from emacs to elisp)
-are correct.  (Is there an automated way to do this?)
+are correct.  You can use something like the following in the info
+directory in the Emacs build tree:
+
+emacs -Q --eval "(setq Info-default-directory-list '(\".\"))" \
+  -f info-xref-check-all
 
 make emacs.dvi, elisp.dvi, and deal with any errors (undefined
 references etc) in the output.  Break any overfull lines.
@@ -19,11 +23,22 @@ 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/.
+Check for widow and orphan lines in the printed manual; make sure all
+the pages really look ok in the manual as formatted.  Orphans/widows
+are cases where the first/last line of a paragraph is on its own at
+the end/start of a page, or where the last word in a paragraph is on
+its own at the start of a line.  It looks better if you reword/respace
+things to avoid these.  (AFAIK, there is no way to find these except
+paging through the whole manual.)  This should be the very last thing
+you do, since any change can alter the layout.
+
+** Check the keybindings in the refcards are correct, and add any new ones.
+Regenerate the pdf versions in etc/refcards/.
+What paper size are the English versions supposed to be on?
+On Debian testing, the packages texlive-lang-czechslovak and
+texlive-lang-polish will let you generate the cs-* and sk-* pdfs.
+The Makefile rules did not work for me, I had to use something like:
+csplain -output-format=pdf cs-refcard
 
 ** Ask maintainers of refcard translations to update them.
 
@@ -66,16 +81,12 @@ and change key bindings where necessary.  The current list of modes:
 2. Minibuffer binds `M-s' to `next-matching-history-element'
    (not useful any more since C-s can now search in the history).
 
-3. Shell mode binds `M-s' to `comint-next-matching-input'.
-   This key binding can be changed later when we will implement
-   incremental search through the shell history.
-
-4. `center-line' in Text mode was already moved to the text formatting
+3. `center-line' in Text mode was already moved to the text formatting
    keymap as `M-o M-s' (thus this binding is not necessary any more
    in `nroff-mode-map' too and can be removed now from the nroff mode
    because it can now use the global key binding `M-o M-s' `center-line').
 
-5. PCL-CVS binds `M-s' to `cvs-status', and log-edit-mode binds it to
+4. PCL-CVS binds `M-s' to `cvs-status', and log-edit-mode binds it to
    `log-edit-comment-search-forward'.  Perhaps search commands
    on the global key binding `M-s' are useless in these modes.
 
@@ -241,8 +252,6 @@ windows.texi      -- rudalics
 
 * PLANNED ADDITIONS
 
-** CEDET (not for 23.1 due to paperwork issues, perhaps for 23.2)
-** js2-mode
 ** pov-mode (probably not for Emacs-23: waiting for a Free POV-Ray).
 ** gas-mode ?