X-Git-Url: https://git.hcoop.net/bpt/emacs.git/blobdiff_plain/72e892eb3aea4f3a9e83e743cbaafe4bd932eb8a..01f5787b8a4c21a1414e9e5202323d56b4aea3b8:/admin/FOR-RELEASE diff --git a/admin/FOR-RELEASE b/admin/FOR-RELEASE index b2eb9de76c..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. @@ -72,12 +103,6 @@ Fixed by this change? ** In C, use EMACS_INT for variables and structure members for buffer/string positions. E.g. struct it, struct text_pos. -** Rmail issues: - -mail/rmail-spam-filter.el: check it still (?) works - -Update the rmail (and gnus) manuals for mbox rmail. - * DOCUMENTATION ** Clean up Emacs.app references in code and documentation. @@ -98,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 @@ -141,94 +166,92 @@ 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 -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 ?