X-Git-Url: http://git.hcoop.net/bpt/emacs.git/blobdiff_plain/6638d82aed325b79578bc6091bb641d4c660dfe6..8b492194a904d115258ae59eb522c986860c4c18:/admin/FOR-RELEASE diff --git a/admin/FOR-RELEASE b/admin/FOR-RELEASE index 9e5bf85130..4533026204 100644 --- a/admin/FOR-RELEASE +++ b/admin/FOR-RELEASE @@ -2,10 +2,43 @@ 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. - -** 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. @@ -24,6 +57,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? @@ -46,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. @@ -92,11 +123,11 @@ names of the people who have checked it. 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 @@ -135,25 +166,24 @@ emacs.texi -- cyd 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 @@ -163,15 +193,15 @@ search.texi -- cyd 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 +abbrevs.texi -- cyd advice.texi -- cyd -anti.texi +anti.texi -- cyd back.texi backups.texi -- cyd buffers.texi -- cyd @@ -180,50 +210,48 @@ compile.texi -- cyd control.texi -- cyd customize.texi -- cyd debugging.texi -- cyd -display.texi +display.texi -- cyd edebug.texi elisp.texi -errors.texi +errors.texi -- cyd eval.texi -- cyd files.texi -- cyd frames.texi -- cyd functions.texi -- cyd hash.texi -- cyd help.texi -- cyd -hooks.texi +hooks.texi -- cyd index.texi -internals.texi +internals.texi -- cyd intro.texi -- cyd keymaps.texi -- cyd lists.texi -- cyd loading.texi -- cyd -locals.texi +locals.texi -- cyd macros.texi -- cyd -maps.texi +maps.texi -- cyd markers.texi -- cyd minibuf.texi -- cyd modes.texi -- cyd -nonascii.texi +nonascii.texi -- cyd numbers.texi -- cyd objects.texi -- cyd -os.texi +os.texi -- cyd positions.texi -- cyd processes.texi -searching.texi +searching.texi -- cyd sequences.texi -- cyd streams.texi -- cyd strings.texi -- cyd symbols.texi -- cyd -syntax.texi -text.texi -tips.texi +syntax.texi -- cyd +text.texi -- cyd +tips.texi -- cyd variables.texi -- cyd -windows.texi +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 ?