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