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 "(setq Info-default-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 ** Regenerate the pdf versions of the reference cards in etc/refcards/.
  36
  37 ** Ask maintainers of refcard translations to update them.
  38
  39 Emacs 22 translators:
  40
  41 LANG    Translator            Status
  42 cs      Pavel Janík
  43 de      Sven Joachim
  44 fr      Eric Jacoboni
  45 pl      Włodek Bzyl
  46 pt-br   Rodrigo Real
  47 ru      Alex Ott
  48 sk      Miroslav Vaško
  49
  50 ** Remove temporary +++/--- lines in NEWS.
  51
  52 ** Try to reorder NEWS: most important things first, related items together.
  53
  54 ** Consider bumping customize-changed-options-previous-release.
  55
  56 * BUGS
  57
  58 ** Does deleting frames run Lisp code?  If so, can we get rid of that?
  59 It is a dangerous design.
  60 http://lists.gnu.org/archive/html/emacs-devel/2007-09/msg01330.html
  61
  62 ** Why were the calls to x_fully_uncatch_errors commented out in eval.c?
  63 http://lists.gnu.org/archive/html/emacs-devel/2007-09/msg01987.html
  64
  65 ** rms: gnus-dired.el is a mistake.  Those features should not
  66 be part of Gnus.  They should be moved to some other part of Emacs.
  67 rsteib: Gnus dependencies in `gnus-dired.el' (and `mailcap.el') have been
  68 minimized.  I don't know what is left to do here.
  69
  70 ** Check for modes which bind M-s that conflicts with a new global binding M-s
  71 and change key bindings where necessary.  The current list of modes:
  72
  73 1. Gnus binds `M-s' to `gnus-summary-search-article-forward'.
  74
  75 2. Minibuffer binds `M-s' to `next-matching-history-element'
  76    (not useful any more since C-s can now search in the history).
  77
  78 3. Shell mode binds `M-s' to `comint-next-matching-input'.
  79    This key binding can be changed later when we will implement
  80    incremental search through the shell history.
  81
  82 4. `center-line' in Text mode was already moved to the text formatting
  83    keymap as `M-o M-s' (thus this binding is not necessary any more
  84    in `nroff-mode-map' too and can be removed now from the nroff mode
  85    because it can now use the global key binding `M-o M-s' `center-line').
  86
  87 5. PCL-CVS binds `M-s' to `cvs-status', and log-edit-mode binds it to
  88    `log-edit-comment-search-forward'.  Perhaps search commands
  89    on the global key binding `M-s' are useless in these modes.
  90
  91 ** sdl.web@gmail.com, 30 Oct: ps-lpr-switches has no effect
  92 http://lists.gnu.org/archive/html/emacs-devel/2007-10/msg02091.html
  93
  94 Fixed by this change?
  95
  96 2007-11-09  Vinicius Jose Latorre  <viniciusjl@ig.com.br>
  97
  98         * ps-print.el: [...]
  99         (ps-do-despool): If ps-lpr-switches is not a list, force it to be one.
 100
 101 ** In C, use EMACS_INT for variables and structure members
 102 for buffer/string positions.  E.g. struct it, struct text_pos.
 103
 104 * DOCUMENTATION
 105
 106 ** Clean up Emacs.app references in code and documentation.
 107
 108 ** Document new font backend
 109
 110 ** Document XEmbed support
 111
 112 ** Check the Emacs Tutorial.
 113
 114 The first line of every tutorial must begin with text ending in a
 115 period (".", ASCII 0x2E) saying "Emacs Tutorial" in the respective
 116 language. This should be followed by "See end for copying conditions",
 117 likewise in the respective language.
 118
 119 After each file name, on the same line or the following line, come the
 120 names of the people who have checked it.
 121
 122 SECTION                  READERS
 123 ----------------------------------
 124 etc/TUTORIAL             rgm (but see Bug#3783)
 125 etc/TUTORIAL.bg
 126 etc/TUTORIAL.cn
 127 etc/TUTORIAL.cs
 128 etc/TUTORIAL.de          Werner Lemberg
 129 etc/TUTORIAL.eo
 130 etc/TUTORIAL.es
 131 etc/TUTORIAL.fr
 132 etc/TUTORIAL.it
 133 etc/TUTORIAL.ja
 134 etc/TUTORIAL.ko
 135 etc/TUTORIAL.nl
 136 etc/TUTORIAL.pl
 137 etc/TUTORIAL.pt_BR
 138 etc/TUTORIAL.ro
 139 etc/TUTORIAL.ru
 140 etc/TUTORIAL.sk
 141 etc/TUTORIAL.sl
 142 etc/TUTORIAL.sv
 143 etc/TUTORIAL.th
 144 etc/TUTORIAL.zh
 145
 146 ** Check the manual.
 147
 148 abbrevs.texi      -- cyd
 149 ack.texi          -- rgm
 150 anti.texi
 151 arevert-xtra.texi
 152 basic.texi        -- cyd
 153 buffers.texi      -- cyd
 154 building.texi     -- cyd
 155 calendar.texi     -- rgm
 156 cal-xtra.texi     -- rgm
 157 cmdargs.texi      -- cyd
 158 commands.texi     -- cyd
 159 custom.texi       -- cyd
 160 dired.texi        -- cyd
 161 dired-xtra.texi
 162 display.texi      -- cyd
 163 emacs.texi        -- cyd
 164 emacs-xtra.texi
 165 emerge-xtra.texi
 166 entering.texi     -- cyd
 167 files.texi        -- cyd
 168 fixit.texi        -- cyd
 169 fortran-xtra.texi -- rgm
 170 frames.texi       -- cyd
 171 glossary.texi
 172 help.texi         -- cyd
 173 indent.texi       -- cyd
 174 killing.texi      -- cyd
 175 kmacro.texi       -- cyd
 176 macos.texi     -- davidswelt
 177 maintaining.texi  -- cyd
 178 major.texi        -- cyd
 179 mark.texi         -- cyd
 180 mini.texi         -- cyd
 181 misc.texi         -- cyd
 182 msdog.texi        -- eliz
 183 msdog-xtra.texi   -- eliz
 184 mule.texi         -- cyd
 185 m-x.texi          -- cyd
 186 programs.texi     -- cyd
 187 regs.texi         -- cyd
 188 rmail.texi        -- rgm
 189 screen.texi       -- cyd
 190 search.texi       -- cyd
 191 sending.texi      -- rgm (maybe needs some brief mailclient.el details in
 192                           "Mail Sending" section?)
 193 text.texi         -- cyd
 194 trouble.texi      -- cyd
 195 windows.texi      -- rudalics
 196 xresources.texi   -- cyd
 197
 198 ** Check the Lisp manual.
 199
 200 abbrevs.texi      -- cyd
 201 advice.texi       -- cyd
 202 anti.texi         -- cyd
 203 back.texi
 204 backups.texi      -- cyd
 205 buffers.texi      -- cyd
 206 commands.texi     -- cyd
 207 compile.texi      -- cyd
 208 control.texi      -- cyd
 209 customize.texi    -- cyd
 210 debugging.texi    -- cyd
 211 display.texi      -- cyd
 212 edebug.texi
 213 elisp.texi
 214 errors.texi       -- cyd
 215 eval.texi         -- cyd
 216 files.texi        -- cyd
 217 frames.texi       -- cyd
 218 functions.texi    -- cyd
 219 hash.texi         -- cyd
 220 help.texi         -- cyd
 221 hooks.texi        -- cyd
 222 index.texi
 223 internals.texi    -- cyd
 224 intro.texi        -- cyd
 225 keymaps.texi      -- cyd
 226 lists.texi        -- cyd
 227 loading.texi      -- cyd
 228 locals.texi       -- cyd
 229 macros.texi       -- cyd
 230 maps.texi         -- cyd
 231 markers.texi      -- cyd
 232 minibuf.texi      -- cyd
 233 modes.texi        -- cyd
 234 nonascii.texi     -- cyd
 235 numbers.texi      -- cyd
 236 objects.texi      -- cyd
 237 os.texi           -- cyd
 238 positions.texi    -- cyd
 239 processes.texi
 240 searching.texi    -- cyd
 241 sequences.texi    -- cyd
 242 streams.texi      -- cyd
 243 strings.texi      -- cyd
 244 symbols.texi      -- cyd
 245 syntax.texi       -- cyd
 246 text.texi         -- cyd
 247 tips.texi         -- cyd
 248 variables.texi    -- cyd
 249 windows.texi      -- rudalics
 250
 251 * PLANNED ADDITIONS
 252
 253 ** CEDET (not for 23.1 due to paperwork issues, perhaps for 23.2)
 254 ** js2-mode
 255 ** pov-mode (probably not for Emacs-23: waiting for a Free POV-Ray).
 256 ** gas-mode ?
 257
 258 \f
 259 Local variables:
 260 mode: outline
 261 coding: utf-8
 262 end: