* 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.
-
-** Regenerate the pdf versions of the reference cards in etc/refcards/.
+** Manuals
+Check cross-references between the manuals (eg from emacs to elisp)
+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.
+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 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.
** 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?
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.
** In C, use EMACS_INT for variables and structure members
for buffer/string positions. E.g. struct it, struct text_pos.
-** Rmail issues:
-
-rmail-spam-filter.el: seems to work, but needs more checking.
-Update the rmail (and gnus) manuals for mbox rmail.
-
* DOCUMENTATION
** Clean up Emacs.app references in code and documentation.
SECTION READERS
----------------------------------
-etc/TUTORIAL
+etc/TUTORIAL rgm (but see Bug#3783)
etc/TUTORIAL.bg
etc/TUTORIAL.cn
etc/TUTORIAL.cs
-etc/TUTORIAL.de
+etc/TUTORIAL.de Werner Lemberg
etc/TUTORIAL.eo
etc/TUTORIAL.es
etc/TUTORIAL.fr
emacs-xtra.texi
emerge-xtra.texi
entering.texi -- cyd
-files.texi
+files.texi -- cyd
fixit.texi -- cyd
fortran-xtra.texi -- rgm
frames.texi -- cyd
glossary.texi
-help.texi
+help.texi -- cyd
indent.texi -- cyd
killing.texi -- cyd
kmacro.texi -- cyd
-macos.texi -- contents need to be evaluated and see what is still
- relevant after the NS merge.
+macos.texi -- davidswelt
maintaining.texi -- cyd
major.texi -- cyd
mark.texi -- cyd
mini.texi -- cyd
-misc.texi
-msdog.texi
-msdog-xtra.texi
-mule.texi
+misc.texi -- cyd
+msdog.texi -- eliz
+msdog-xtra.texi -- eliz
+mule.texi -- cyd
m-x.texi -- cyd
programs.texi -- cyd
regs.texi -- cyd
-rmail.texi
+rmail.texi -- rgm
screen.texi -- cyd
search.texi -- cyd
-sending.texi
+sending.texi -- rgm (maybe needs some brief mailclient.el details in
+ "Mail Sending" section?)
text.texi -- cyd
-trouble.texi
+trouble.texi -- cyd
windows.texi -- rudalics
-xresources.texi
+xresources.texi -- cyd
** Check the Lisp manual.
-abbrevs.texi
-advice.texi
-anti.texi
+abbrevs.texi -- cyd
+advice.texi -- cyd
+anti.texi -- cyd
back.texi
-backups.texi
-buffers.texi
-commands.texi
-compile.texi
-control.texi
-customize.texi
-debugging.texi
-display.texi
+backups.texi -- cyd
+buffers.texi -- cyd
+commands.texi -- cyd
+compile.texi -- cyd
+control.texi -- cyd
+customize.texi -- cyd
+debugging.texi -- cyd
+display.texi -- cyd
edebug.texi
elisp.texi
-errors.texi
-eval.texi
-files.texi
-frames.texi
-functions.texi
-hash.texi
-help.texi
-hooks.texi
+errors.texi -- cyd
+eval.texi -- cyd
+files.texi -- cyd
+frames.texi -- cyd
+functions.texi -- cyd
+hash.texi -- cyd
+help.texi -- cyd
+hooks.texi -- cyd
index.texi
-internals.texi
-intro.texi
-keymaps.texi
-lists.texi
-loading.texi
-locals.texi
-macros.texi
-maps.texi
-markers.texi
-minibuf.texi
-modes.texi
-nonascii.texi
-numbers.texi
-objects.texi
-os.texi
-positions.texi
+internals.texi -- cyd
+intro.texi -- cyd
+keymaps.texi -- cyd
+lists.texi -- cyd
+loading.texi -- cyd
+locals.texi -- cyd
+macros.texi -- cyd
+maps.texi -- cyd
+markers.texi -- cyd
+minibuf.texi -- cyd
+modes.texi -- cyd
+nonascii.texi -- cyd
+numbers.texi -- cyd
+objects.texi -- cyd
+os.texi -- cyd
+positions.texi -- cyd
processes.texi
-searching.texi
-sequences.texi
-streams.texi
-strings.texi
-symbols.texi
-syntax.texi
-text.texi
-tips.texi
-variables.texi
-windows.texi
+searching.texi -- cyd
+sequences.texi -- cyd
+streams.texi -- cyd
+strings.texi -- cyd
+symbols.texi -- cyd
+syntax.texi -- cyd
+text.texi -- cyd
+tips.texi -- cyd
+variables.texi -- cyd
+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 ?
HCoop / bpt / emacs.git / blobdiff