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. `center-line' in Text mode was already moved to the text formatting
  85    keymap as `M-o M-s' (thus this binding is not necessary any more
  86    in `nroff-mode-map' too and can be removed now from the nroff mode
  87    because it can now use the global key binding `M-o M-s' `center-line').
  88
  89 4. PCL-CVS binds `M-s' to `cvs-status', and log-edit-mode binds it to
  90    `log-edit-comment-search-forward'.  Perhaps search commands
  91    on the global key binding `M-s' are useless in these modes.
  92
  93 ** sdl.web@gmail.com, 30 Oct: ps-lpr-switches has no effect
  94 http://lists.gnu.org/archive/html/emacs-devel/2007-10/msg02091.html
  95
  96 Fixed by this change?
  97
  98 2007-11-09  Vinicius Jose Latorre  <viniciusjl@ig.com.br>
  99
 100         * ps-print.el: [...]
 101         (ps-do-despool): If ps-lpr-switches is not a list, force it to be one.
 102
 103 ** In C, use EMACS_INT for variables and structure members
 104 for buffer/string positions.  E.g. struct it, struct text_pos.
 105
 106 * DOCUMENTATION
 107
 108 ** Clean up Emacs.app references in code and documentation.
 109
 110 ** Document new font backend
 111
 112 ** Document XEmbed support
 113
 114 ** Check the Emacs Tutorial.
 115
 116 The first line of every tutorial must begin with text ending in a
 117 period (".", ASCII 0x2E) saying "Emacs Tutorial" in the respective
 118 language. This should be followed by "See end for copying conditions",
 119 likewise in the respective language.
 120
 121 After each file name, on the same line or the following line, come the
 122 names of the people who have checked it.
 123
 124 SECTION                  READERS
 125 ----------------------------------
 126 TUTORIAL
 127 TUTORIAL.bg
 128 TUTORIAL.cn
 129 TUTORIAL.cs
 130 TUTORIAL.de
 131 TUTORIAL.eo
 132 TUTORIAL.es
 133 TUTORIAL.fr
 134 TUTORIAL.he
 135 TUTORIAL.it
 136 TUTORIAL.ja
 137 TUTORIAL.ko
 138 TUTORIAL.nl
 139 TUTORIAL.pl
 140 TUTORIAL.pt_BR
 141 TUTORIAL.ro
 142 TUTORIAL.ru
 143 TUTORIAL.sk
 144 TUTORIAL.sl
 145 TUTORIAL.sv
 146 TUTORIAL.th
 147 TUTORIAL.zh
 148
 149 ** Check the manual.
 150
 151 abbrevs.texi
 152 ack.texi
 153 anti.texi
 154 arevert-xtra.texi cyd
 155 basic.texi        cyd
 156 buffers.texi      cyd
 157 building.texi
 158 calendar.texi
 159 cal-xtra.texi
 160 cmdargs.texi
 161 commands.texi     cyd
 162 custom.texi
 163 dired.texi
 164 dired-xtra.texi
 165 display.texi      cyd
 166 emacs.texi
 167 emacs-xtra.texi
 168 emerge-xtra.texi
 169 entering.texi     cyd
 170 files.texi        cyd
 171 fixit.texi
 172 fortran-xtra.texi
 173 frames.texi       cyd
 174 glossary.texi
 175 help.texi         cyd
 176 indent.texi
 177 killing.texi      cyd
 178 kmacro.texi       cyd
 179 macos.texi
 180 maintaining.texi
 181 major.texi
 182 mark.texi         cyd
 183 mini.texi
 184 misc.texi
 185 modes.texi        cyd
 186 msdog.texi
 187 msdog-xtra.texi
 188 mule.texi
 189 m-x.texi          cyd
 190 picture-xtra.texi
 191 programs.texi
 192 regs.texi         cyd
 193 rmail.texi
 194 screen.texi       cyd
 195 search.texi       cyd
 196 sending.texi
 197 text.texi
 198 trouble.texi
 199 vc-xtra.texi
 200 vc1-xtra.texi
 201 windows.texi      cyd
 202 xresources.texi
 203
 204 ** Check the Lisp manual.
 205
 206 abbrevs.texi
 207 advice.texi
 208 anti.texi
 209 back.texi
 210 backups.texi
 211 buffers.texi
 212 commands.texi
 213 compile.texi
 214 control.texi
 215 customize.texi
 216 debugging.texi
 217 display.texi
 218 edebug.texi
 219 elisp.texi
 220 errors.texi
 221 eval.texi
 222 files.texi
 223 frames.texi
 224 functions.texi
 225 hash.texi
 226 help.texi
 227 hooks.texi
 228 index.texi
 229 internals.texi
 230 intro.texi
 231 keymaps.texi
 232 lists.texi
 233 loading.texi
 234 locals.texi
 235 macros.texi
 236 maps.texi
 237 markers.texi
 238 minibuf.texi
 239 modes.texi
 240 nonascii.texi
 241 numbers.texi
 242 objects.texi
 243 os.texi
 244 package.texi
 245 positions.texi
 246 processes.texi
 247 searching.texi
 248 sequences.texi
 249 streams.texi
 250 strings.texi
 251 symbols.texi
 252 syntax.texi
 253 text.texi
 254 tips.texi
 255 variables.texi
 256 windows.texi
 257
 258 * PLANNED ADDITIONS
 259
 260 ** pov-mode (probably not for Emacs-23: waiting for a Free POV-Ray).
 261 ** gas-mode ?
 262
 263 \f
 264 Local variables:
 265 mode: outline
 266 coding: utf-8
 267 end: