X-Git-Url: http://git.hcoop.net/bpt/emacs.git/blobdiff_plain/279299b0b11e075720b593e1fae5bf3a48dfd3f3..e097a6fa863b26952a476e71a786fa7b2460277b:/admin/FOR-RELEASE diff --git a/admin/FOR-RELEASE b/admin/FOR-RELEASE index 45e2bf39a9..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? @@ -38,6 +73,23 @@ be part of Gnus. They should be moved to some other part of Emacs. rsteib: Gnus dependencies in `gnus-dired.el' (and `mailcap.el') have been minimized. I don't know what is left to do here. +** Check for modes which bind M-s that conflicts with a new global binding M-s +and change key bindings where necessary. The current list of modes: + +1. Gnus binds `M-s' to `gnus-summary-search-article-forward'. + +2. Minibuffer binds `M-s' to `next-matching-history-element' + (not useful any more since C-s can now search in the history). + +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'). + +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. + ** sdl.web@gmail.com, 30 Oct: ps-lpr-switches has no effect http://lists.gnu.org/archive/html/emacs-devel/2007-10/msg02091.html @@ -55,12 +107,6 @@ for buffer/string positions. E.g. struct it, struct text_pos. ** Clean up Emacs.app references in code and documentation. -** Verify if doc/emacs/macos.texi is still useful, remove it if it is not. - -** Document multi-tty features -http://lists.gnu.org/archive/html/emacs-devel/2007-08/msg01639.html -http://lists.gnu.org/archive/html/emacs-devel/2007-08/msg01602.html - ** Document new font backend ** Document XEmbed support @@ -77,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 @@ -101,115 +147,111 @@ etc/TUTORIAL.zh ** Check the manual. -abbrevs.texi -ack.texi +abbrevs.texi -- cyd +ack.texi -- rgm anti.texi arevert-xtra.texi basic.texi -- cyd buffers.texi -- cyd -building.texi +building.texi -- cyd calendar.texi -- rgm cal-xtra.texi -- rgm -cmdargs.texi +cmdargs.texi -- cyd commands.texi -- cyd -custom.texi -dired.texi +custom.texi -- cyd +dired.texi -- cyd dired-xtra.texi display.texi -- cyd 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 -indent.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. (If this is here, why is ns-emacs.texi - relegated to doc/misc?) -maintaining.texi +macos.texi -- davidswelt +maintaining.texi -- cyd major.texi -- cyd mark.texi -- cyd mini.texi -- cyd -misc.texi -msdog.texi -msdog-xtra.texi -mule.texi -m-x.texi -programs.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 -sending.texi -text.texi -trouble.texi -windows.texi -xresources.texi +search.texi -- cyd +sending.texi -- rgm (maybe needs some brief mailclient.el details in + "Mail Sending" section?) +text.texi -- cyd +trouble.texi -- cyd +windows.texi -- rudalics +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) -** ruby-mode -** js2-mode ** pov-mode (probably not for Emacs-23: waiting for a Free POV-Ray). ** gas-mode ?