admin/FOR-RELEASE

   1 Tasks needed before the next release.
   2
   3 * TO BE DONE SHORTLY BEFORE RELEASE
   4
   5 ** Manuals
   6 Check cross-references between the manuals (eg from emacs to elisp)
   7 are correct.  You can use something like the following in the info
   8 directory in the Emacs build tree:
   9
  10 emacs -Q --eval "(progn (require 'info) (setq Info-directory-list '(\".\")))" \
  11   -f info-xref-check-all
  12
  13 make emacs.dvi, elisp.dvi, and deal with any errors (undefined
  14 references etc) in the output.  Break any overfull lines.
  15 Underfull hboxes are not serious, but it can be nice to get rid of
  16 them if a simple rephrasing or rearrangement will work.
  17
  18 Update the master menu and detailed menu (eg the antinews version).
  19 The command texinfo-multiple-files-update can do this, but you
  20 probably want to apply the results selectively (eg the current master
  21 menu has better line-breaks than the automatic version).  It includes
  22 the menu-entry name (if there is one) as well as the node name - using
  23 only the latter looks better.  Also, it doesn't seem to handle nested
  24 includes, so will miss edebug.texi etc.
  25
  26 Check for widow and orphan lines in the printed manual; make sure all
  27 the pages really look ok in the manual as formatted.  Orphans/widows
  28 are cases where the first/last line of a paragraph is on its own at
  29 the end/start of a page, or where the last word in a paragraph is on
  30 its own at the start of a line.  It looks better if you reword/respace
  31 things to avoid these.  (AFAIK, there is no way to find these except
  32 paging through the whole manual.)  This should be the very last thing
  33 you do, since any change can alter the layout.
  34
  35 ** Check the keybindings in the refcards are correct, and add any new ones.
  36 Regenerate the pdf versions in etc/refcards/.
  37 What paper size are the English versions supposed to be on?
  38 On Debian testing, the packages texlive-lang-czechslovak and
  39 texlive-lang-polish will let you generate the cs-* and sk-* pdfs.
  40 The Makefile rules did not work for me, I had to use something like:
  41 csplain -output-format=pdf cs-refcard
  42
  43 ** Ask maintainers of refcard translations to update them.
  44
  45 Emacs 22 translators:
  46
  47 LANG    Translator            Status
  48 cs      Pavel Janík
  49 de      Sven Joachim
  50 fr      Eric Jacoboni
  51 pl      Włodek Bzyl
  52 pt-br   Rodrigo Real
  53 ru      Alex Ott
  54 sk      Miroslav Vaško
  55
  56 ** Remove temporary +++/--- lines in NEWS.
  57
  58 ** Try to reorder NEWS: most important things first, related items together.
  59
  60 ** Consider bumping customize-changed-options-previous-release.
  61
  62 * BUGS
  63
  64 ** Check for modes which bind M-s that conflicts with a new global binding M-s
  65 and change key bindings where necessary.  The current list of modes:
  66
  67 1. Gnus binds `M-s' to `gnus-summary-search-article-forward'.
  68
  69 2. Minibuffer binds `M-s' to `next-matching-history-element'
  70    (not useful any more since C-s can now search in the history).
  71
  72 3. `center-line' in Text mode was already moved to the text formatting
  73    keymap as `M-o M-s' (thus this binding is not necessary any more
  74    in `nroff-mode-map' too and can be removed now from the nroff mode
  75    because it can now use the global key binding `M-o M-s' `center-line').
  76
  77 4. PCL-CVS binds `M-s' to `cvs-status', and log-edit-mode binds it to
  78    `log-edit-comment-search-forward'.  Perhaps search commands
  79    on the global key binding `M-s' are useless in these modes.
  80
  81 5. Rmail binds `\es' to `rmail-search'/`rmail-summary-search'.
  82
  83
  84 * DOCUMENTATION
  85
  86 ** Check the Emacs Tutorial.
  87
  88 The first line of every tutorial must begin with text ending in a
  89 period (".", ASCII 0x2E) saying "Emacs Tutorial" in the respective
  90 language. This should be followed by "See end for copying conditions",
  91 likewise in the respective language.
  92
  93 After each file name, on the same line or the following line, come the
  94 names of the people who have checked it.
  95
  96 SECTION                  READERS
  97 ----------------------------------
  98 TUTORIAL             cyd
  99 TUTORIAL.bg          ogi
 100 TUTORIAL.cn
 101 TUTORIAL.cs
 102 TUTORIAL.de          wl
 103 TUTORIAL.eo
 104 TUTORIAL.es
 105 TUTORIAL.fr
 106 TUTORIAL.he          eliz
 107 TUTORIAL.it
 108 TUTORIAL.ja
 109 TUTORIAL.ko
 110 TUTORIAL.nl          Pieter Schoenmakers
 111 TUTORIAL.pl
 112 TUTORIAL.pt_BR
 113 TUTORIAL.ro
 114 TUTORIAL.ru          Alex Ott
 115 TUTORIAL.sk
 116 TUTORIAL.sl          Primoz PETERLIN
 117 TUTORIAL.sv          Mats Lidell
 118 TUTORIAL.th
 119 TUTORIAL.zh
 120
 121 ** Check the manual.
 122
 123 abbrevs.texi      cyd
 124 ack.texi          rgm
 125 anti.texi         cyd
 126 arevert-xtra.texi cyd
 127 basic.texi        cyd
 128 buffers.texi      cyd
 129 building.texi     cyd
 130 calendar.texi     rgm
 131 cal-xtra.texi     rgm
 132 cmdargs.texi      cyd
 133 commands.texi     cyd
 134 custom.texi       cyd
 135 dired.texi        cyd
 136 dired-xtra.texi   rgm
 137 display.texi      cyd
 138 emacs.texi        rgm
 139 emacs-xtra.texi   rgm
 140 emerge-xtra.texi  rgm
 141 entering.texi     cyd
 142 files.texi        cyd
 143 fixit.texi        cyd
 144 fortran-xtra.texi rgm
 145 frames.texi       cyd
 146 glossary.texi     rgm
 147 help.texi         cyd
 148 indent.texi       cyd
 149 killing.texi      cyd
 150 kmacro.texi       cyd
 151 macos.texi        rgm  (can't actually test any of it though)
 152 maintaining.texi  cyd
 153 mark.texi         cyd
 154 mini.texi         rgm
 155 misc.texi         cyd
 156 modes.texi        cyd
 157 msdog.texi        rgm  (can't actually test any of it though)
 158   It was not obvious to me that the following is true (it could well be though):
 159
 160    Emacs on Windows automatically determines your default printer and
 161    sets the variable `printer-name' to that printer's name.
 162
 163 msdog-xtra.texi   rgm  (can't actually test any of it though)
 164 mule.texi
 165 m-x.texi          cyd
 166 package.texi      cyd
 167 picture-xtra.texi rgm
 168 programs.texi     cyd
 169 regs.texi         cyd
 170 rmail.texi        rgm
 171 screen.texi       cyd
 172 search.texi       cyd
 173 sending.texi      cyd
 174 text.texi         cyd
 175 trouble.texi      cyd
 176 vc-xtra.texi      cyd
 177 vc1-xtra.texi     cyd
 178 windows.texi      cyd
 179 xresources.texi   cyd
 180
 181 ** Check the Lisp manual.
 182
 183 abbrevs.texi      rgm
 184 advice.texi       cyd
 185 anti.texi
 186 back.texi         rgm
 187 backups.texi      cyd
 188 buffers.texi      cyd
 189 commands.texi     cyd
 190 compile.texi      cyd
 191 control.texi      cyd
 192 customize.texi    cyd
 193 debugging.texi    cyd
 194 display.texi      cyd
 195 edebug.texi       rgm
 196 elisp.texi
 197 errors.texi       rgm
 198 eval.texi         cyd
 199 files.texi        cyd
 200 frames.texi       cyd
 201 functions.texi    cyd
 202 hash.texi         cyd
 203 help.texi         cyd
 204 hooks.texi        rgm
 205 index.texi
 206 internals.texi    rgm  cyd
 207 intro.texi        cyd
 208 keymaps.texi      cyd
 209 lists.texi        cyd
 210 loading.texi      cyd
 211 macros.texi       cyd
 212 maps.texi         rgm
 213 markers.texi      rgm
 214 minibuf.texi
 215 modes.texi        cyd
 216 nonascii.texi     cyd
 217 numbers.texi      cyd
 218 objects.texi      cyd
 219 os.texi           cyd
 220 package.texi      rgm
 221 positions.texi    cyd
 222 processes.texi
 223 searching.texi    rgm
 224 sequences.texi    cyd
 225 streams.texi      cyd
 226 strings.texi      cyd
 227 symbols.texi      cyd
 228 syntax.texi       cyd
 229 text.texi         cyd
 230 tips.texi         rgm
 231 variables.texi    cyd
 232 windows.texi
 233
 234 \f
 235 Local variables:
 236 mode: outline
 237 coding: utf-8
 238 end: