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 * DOCUMENTATION
  82
  83 ** Document XEmbed support
  84
  85 ** Check the Emacs Tutorial.
  86
  87 The first line of every tutorial must begin with text ending in a
  88 period (".", ASCII 0x2E) saying "Emacs Tutorial" in the respective
  89 language. This should be followed by "See end for copying conditions",
  90 likewise in the respective language.
  91
  92 After each file name, on the same line or the following line, come the
  93 names of the people who have checked it.
  94
  95 SECTION                  READERS
  96 ----------------------------------
  97 TUTORIAL             cyd
  98 TUTORIAL.bg          ogi
  99 TUTORIAL.cn
 100 TUTORIAL.cs
 101 TUTORIAL.de          wl
 102 TUTORIAL.eo
 103 TUTORIAL.es
 104 TUTORIAL.fr
 105 TUTORIAL.he          eliz
 106 TUTORIAL.it
 107 TUTORIAL.ja
 108 TUTORIAL.ko
 109 TUTORIAL.nl          Pieter Schoenmakers
 110 TUTORIAL.pl
 111 TUTORIAL.pt_BR
 112 TUTORIAL.ro
 113 TUTORIAL.ru          Alex Ott
 114 TUTORIAL.sk
 115 TUTORIAL.sl          Primoz PETERLIN
 116 TUTORIAL.sv          Mats Lidell
 117 TUTORIAL.th
 118 TUTORIAL.zh
 119
 120 ** Check the manual.
 121
 122 abbrevs.texi      cyd
 123 ack.texi
 124 anti.texi         cyd
 125 arevert-xtra.texi cyd
 126 basic.texi        cyd
 127 buffers.texi      cyd
 128 building.texi     cyd
 129 calendar.texi     rgm
 130 cal-xtra.texi     rgm
 131 cmdargs.texi      cyd
 132 commands.texi     cyd
 133 custom.texi       cyd
 134 dired.texi        cyd
 135 dired-xtra.texi   rgm
 136 display.texi      cyd
 137 emacs.texi
 138 emacs-xtra.texi
 139 emerge-xtra.texi
 140 entering.texi     cyd
 141 files.texi        cyd
 142 fixit.texi        cyd
 143 fortran-xtra.texi rgm
 144 frames.texi       cyd
 145 glossary.texi
 146 help.texi         cyd
 147 indent.texi       cyd
 148 killing.texi      cyd
 149 kmacro.texi       cyd
 150 macos.texi
 151 maintaining.texi  cyd
 152 mark.texi         cyd
 153 mini.texi
 154 misc.texi         cyd
 155 modes.texi        cyd
 156 msdog.texi
 157 msdog-xtra.texi
 158 mule.texi
 159 m-x.texi          cyd
 160 package.texi      cyd
 161 picture-xtra.texi
 162 programs.texi     cyd
 163 regs.texi         cyd
 164 rmail.texi
 165 screen.texi       cyd
 166 search.texi       cyd
 167 sending.texi      cyd
 168 text.texi         cyd
 169 trouble.texi      cyd
 170 vc-xtra.texi      cyd
 171 vc1-xtra.texi     cyd
 172 windows.texi      cyd
 173 xresources.texi   cyd
 174
 175 ** Check the Lisp manual.
 176
 177 abbrevs.texi
 178 advice.texi       cyd
 179 anti.texi
 180 back.texi
 181 backups.texi
 182 buffers.texi
 183 commands.texi     cyd
 184 compile.texi      cyd
 185 control.texi      cyd
 186 customize.texi    cyd
 187 debugging.texi    cyd
 188 display.texi
 189 edebug.texi
 190 elisp.texi
 191 errors.texi
 192 eval.texi         cyd
 193 files.texi
 194 frames.texi
 195 functions.texi    cyd
 196 hash.texi         cyd
 197 help.texi
 198 hooks.texi
 199 index.texi
 200 internals.texi
 201 intro.texi        cyd
 202 keymaps.texi      cyd
 203 lists.texi        cyd
 204 loading.texi      cyd
 205 locals.texi
 206 macros.texi       cyd
 207 maps.texi
 208 markers.texi
 209 minibuf.texi
 210 modes.texi
 211 nonascii.texi
 212 numbers.texi      cyd
 213 objects.texi      cyd
 214 os.texi
 215 package.texi
 216 positions.texi
 217 processes.texi
 218 searching.texi
 219 sequences.texi    cyd
 220 streams.texi      cyd
 221 strings.texi      cyd
 222 symbols.texi      cyd
 223 syntax.texi       cyd
 224 text.texi
 225 tips.texi
 226 variables.texi    cyd
 227 windows.texi
 228
 229 * PLANNED ADDITIONS
 230 * pov-mode (waiting for a Free POV-Ray)
 231 ** gas-mode ?
 232
 233 \f
 234 Local variables:
 235 mode: outline
 236 coding: utf-8
 237 end: