]> code.delx.au - gnu-emacs/blobdiff - admin/FOR-RELEASE
* emacs-lisp/autoload.el (generated-autoload-load-name): New var.
[gnu-emacs] / admin / FOR-RELEASE
index 38ae9766e158c0caa27009b0f166638a18ec67b9..1ed535e2ea740f7a8fe8b6e5f331fa9a15c36f4b 100644 (file)
@@ -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?
@@ -92,11 +127,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 +170,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,62 +197,62 @@ 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
-buffers.texi
+backups.texi      -- cyd
+buffers.texi      -- cyd
 commands.texi     -- cyd
 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
-frames.texi
+files.texi        -- cyd
+frames.texi       -- cyd
 functions.texi    -- cyd
 hash.texi         -- cyd
-help.texi
-hooks.texi
+help.texi         -- cyd
+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
-markers.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
-positions.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