FOR-RELEASE 7.48 KB
Newer Older
1 2
Tasks needed before the next release.

Luc Teirlinck's avatar
Luc Teirlinck committed
3
* TO BE DONE SHORTLY BEFORE RELEASE
Luc Teirlinck's avatar
Luc Teirlinck committed
4

Glenn Morris's avatar
Glenn Morris committed
5 6
** Manuals
Check cross-references between the manuals (eg from emacs to elisp)
Glenn Morris's avatar
Glenn Morris committed
7 8 9
are correct.  You can use something like the following in the info
directory in the Emacs build tree:

10
emacs -Q --eval "(progn (require 'info) (setq Info-directory-list '(\".\")))" \
Glenn Morris's avatar
Glenn Morris committed
11
  -f info-xref-check-all
Glenn Morris's avatar
Glenn Morris committed
12 13 14 15 16 17 18 19 20 21 22 23 24 25

make emacs.dvi, elisp.dvi, and deal with any errors (undefined
references etc) in the output.  Break any overfull lines.
Underfull hboxes are not serious, but it can be nice to get rid of
them if a simple rephrasing or rearrangement will work.

Update the master menu and detailed menu (eg the antinews version).
The command texinfo-multiple-files-update can do this, but you
probably want to apply the results selectively (eg the current master
menu has better line-breaks than the automatic version).  It includes
the menu-entry name (if there is one) as well as the node name - using
only the latter looks better.  Also, it doesn't seem to handle nested
includes, so will miss edebug.texi etc.

Glenn Morris's avatar
Glenn Morris committed
26 27 28 29 30 31 32 33
Check for widow and orphan lines in the printed manual; make sure all
the pages really look ok in the manual as formatted.  Orphans/widows
are cases where the first/last line of a paragraph is on its own at
the end/start of a page, or where the last word in a paragraph is on
its own at the start of a line.  It looks better if you reword/respace
things to avoid these.  (AFAIK, there is no way to find these except
paging through the whole manual.)  This should be the very last thing
you do, since any change can alter the layout.
Glenn Morris's avatar
Glenn Morris committed
34 35 36 37 38 39 40 41 42
(Actually, there is probably little point in trying to do this.
It's only really relevant if printed versions of the manuals are going
to be published.  End-users are not likely to print out all 1000+
pages of the manuals, and even if they do, the resulting page breaks
depend on what paper and font size they use.  This also means that if
you _are_ going to do this, it should be done with the paper and font
size that the GNU Press are going to use when they print the manuals.
I think this is different to what you get if you just use eg `make
emacs.pdf' (e.g., enable "smallbook").
43

Glenn Morris's avatar
Glenn Morris committed
44 45 46
** Check the keybindings in the refcards are correct, and add any new ones.
Regenerate the pdf versions in etc/refcards/.
What paper size are the English versions supposed to be on?
Glenn Morris's avatar
Glenn Morris committed
47 48
On Debian testing, the packages texlive-lang-czechslovak and
texlive-lang-polish will let you generate the cs-* and sk-* pdfs.
Glenn Morris's avatar
Glenn Morris committed
49
(You may need texlive-lang-cyrillic, texlive-lang-german for others.)
Glenn Morris's avatar
Glenn Morris committed
50 51
The Makefile rules did not work for me, I had to use something like:
csplain -output-format=pdf cs-refcard
Glenn Morris's avatar
Glenn Morris committed
52

53 54
** Ask maintainers of refcard translations to update them.

Glenn Morris's avatar
Glenn Morris committed
55
Emacs 22 translators:
56 57

LANG	Translator            Status
Glenn Morris's avatar
Glenn Morris committed
58 59 60 61 62 63 64
cs	Pavel Janík           
de	Sven Joachim          
fr	Eric Jacoboni         
pl	Włodek Bzyl           
pt-br	Rodrigo Real          
ru	Alex Ott              
sk	Miroslav Vaško        
65

Glenn Morris's avatar
Glenn Morris committed
66 67
** For a major release, add a "New in Emacs XX" section to faq.texi.

68 69 70 71
** Remove temporary +++/--- lines in NEWS.

** Try to reorder NEWS: most important things first, related items together.

Glenn Morris's avatar
Glenn Morris committed
72 73
** Consider bumping customize-changed-options-previous-release.

Glenn Morris's avatar
Glenn Morris committed
74
** cusver-check from admin.el can help find new defcustoms missing
Glenn Morris's avatar
Glenn Morris committed
75 76
:version tags.

77 78
* BUGS

79 80 81 82 83 84 85 86
** Check for modes which bind M-s that conflicts with a new global binding M-s
and change key bindings where necessary.  The current list of modes:

1. Gnus binds `M-s' to `gnus-summary-search-article-forward'.

2. Minibuffer binds `M-s' to `next-matching-history-element'
   (not useful any more since C-s can now search in the history).

87
3. `center-line' in Text mode was already moved to the text formatting
88 89 90 91
   keymap as `M-o M-s' (thus this binding is not necessary any more
   in `nroff-mode-map' too and can be removed now from the nroff mode
   because it can now use the global key binding `M-o M-s' `center-line').

92
4. PCL-CVS binds `M-s' to `cvs-status', and log-edit-mode binds it to
93 94 95
   `log-edit-comment-search-forward'.  Perhaps search commands
   on the global key binding `M-s' are useless in these modes.

96 97 98
5. Rmail binds `\es' to `rmail-search'/`rmail-summary-search'.


99
* DOCUMENTATION
100

101 102
** Check the Emacs Tutorial.

103 104
The first line of every tutorial must begin with text ending in a
period (".", ASCII 0x2E) saying "Emacs Tutorial" in the respective
Glenn Morris's avatar
Glenn Morris committed
105 106
language. This should be followed by "See end for copying conditions",
likewise in the respective language.
107 108 109 110

After each file name, on the same line or the following line, come the
names of the people who have checked it.

111 112
SECTION                  READERS
----------------------------------
Chong Yidong's avatar
Chong Yidong committed
113
TUTORIAL             cyd
Ognyan Kulev's avatar
Ognyan Kulev committed
114
TUTORIAL.bg          ogi
115 116
TUTORIAL.cn
TUTORIAL.cs          
Ognyan Kulev's avatar
Ognyan Kulev committed
117
TUTORIAL.de          wl
118 119 120
TUTORIAL.eo
TUTORIAL.es          
TUTORIAL.fr          
Eli Zaretskii's avatar
Eli Zaretskii committed
121
TUTORIAL.he          eliz
122 123 124
TUTORIAL.it          
TUTORIAL.ja		 
TUTORIAL.ko
125
TUTORIAL.nl	     Pieter Schoenmakers
126 127 128
TUTORIAL.pl          
TUTORIAL.pt_BR       
TUTORIAL.ro
129
TUTORIAL.ru          Alex Ott
130
TUTORIAL.sk          
Primoz PETERLIN's avatar
Primoz PETERLIN committed
131
TUTORIAL.sl          Primoz PETERLIN
Mats Lidell's avatar
Mats Lidell committed
132
TUTORIAL.sv          Mats Lidell
133 134
TUTORIAL.th          
TUTORIAL.zh
135

Chong Yidong's avatar
Chong Yidong committed
136 137
** Check the manual.

138
abbrevs.texi      cyd
Glenn Morris's avatar
Glenn Morris committed
139
ack.texi          rgm
140
anti.texi         cyd
141
arevert-xtra.texi cyd
Chong Yidong's avatar
Chong Yidong committed
142
basic.texi        cyd
143
buffers.texi      cyd
144
building.texi     cyd
Glenn Morris's avatar
Glenn Morris committed
145
calendar.texi     rgm
146
cal-xtra.texi     rgm
147
cmdargs.texi      cyd
148
commands.texi     cyd
149
custom.texi       cyd
150
dired.texi        cyd
151
dired-xtra.texi   rgm
152
display.texi      cyd
Glenn Morris's avatar
Glenn Morris committed
153
emacs.texi        rgm
154
emacs-xtra.texi   rgm
Glenn Morris's avatar
Glenn Morris committed
155
emerge-xtra.texi  rgm
156
entering.texi     cyd
157
files.texi        cyd
158
fixit.texi        cyd
Glenn Morris's avatar
Glenn Morris committed
159
fortran-xtra.texi rgm
160
frames.texi       cyd
161
glossary.texi     rgm
Chong Yidong's avatar
Chong Yidong committed
162
help.texi         cyd
163
indent.texi       cyd
Chong Yidong's avatar
Chong Yidong committed
164
killing.texi      cyd
165
kmacro.texi       cyd
Glenn Morris's avatar
Glenn Morris committed
166
macos.texi        rgm  (can't actually test any of it though)
167
maintaining.texi  cyd
Chong Yidong's avatar
Chong Yidong committed
168
mark.texi         cyd
Glenn Morris's avatar
Glenn Morris committed
169
mini.texi         rgm
Chong Yidong's avatar
Chong Yidong committed
170
misc.texi         cyd
171
modes.texi        cyd
Glenn Morris's avatar
Glenn Morris committed
172
msdog.texi        rgm  (can't actually test any of it though)
Glenn Morris's avatar
Glenn Morris committed
173
msdog-xtra.texi   rgm  (can't actually test any of it though)
174
mule.texi         rgm  (not 100% sure about "Fontsets")
Chong Yidong's avatar
Chong Yidong committed
175
m-x.texi          cyd
176
package.texi      cyd
177
picture-xtra.texi rgm
178
programs.texi     cyd
Chong Yidong's avatar
Chong Yidong committed
179
regs.texi         cyd
Glenn Morris's avatar
Glenn Morris committed
180
rmail.texi        rgm
181
screen.texi       cyd
182
search.texi       cyd
183
sending.texi      cyd
184
text.texi         cyd
185
trouble.texi      cyd
186 187
vc-xtra.texi      cyd
vc1-xtra.texi     cyd
188
windows.texi      cyd
189
xresources.texi   cyd
Chong Yidong's avatar
Chong Yidong committed
190 191 192

** Check the Lisp manual.

Glenn Morris's avatar
Glenn Morris committed
193
abbrevs.texi      rgm
194
advice.texi       cyd
195
anti.texi         rgm
Glenn Morris's avatar
Glenn Morris committed
196
back.texi         rgm
197
backups.texi      cyd
198
buffers.texi      cyd
199
commands.texi     cyd
200
compile.texi      cyd
201
control.texi      cyd
202
customize.texi    cyd
203
debugging.texi    cyd
204
display.texi      cyd
Glenn Morris's avatar
Glenn Morris committed
205
edebug.texi       rgm
Chong Yidong's avatar
Chong Yidong committed
206
elisp.texi
Glenn Morris's avatar
Glenn Morris committed
207
errors.texi       rgm
208
eval.texi         cyd
209
files.texi        cyd
210
frames.texi       cyd
211
functions.texi    cyd
212
hash.texi         cyd
213
help.texi         cyd
Glenn Morris's avatar
Glenn Morris committed
214
hooks.texi        rgm
Chong Yidong's avatar
Chong Yidong committed
215
index.texi
216
internals.texi    rgm  cyd
Primoz PETERLIN's avatar
Primoz PETERLIN committed
217
intro.texi        cyd
218
keymaps.texi      cyd
219
lists.texi        cyd
220
loading.texi      cyd
221
macros.texi       cyd
Glenn Morris's avatar
Glenn Morris committed
222
maps.texi         rgm
Glenn Morris's avatar
Glenn Morris committed
223
markers.texi      rgm
Glenn Morris's avatar
Glenn Morris committed
224
minibuf.texi      rgm
225
modes.texi        cyd
Chong Yidong's avatar
Chong Yidong committed
226
nonascii.texi     cyd
227
numbers.texi      cyd
Ognyan Kulev's avatar
Ognyan Kulev committed
228
objects.texi      cyd
229
os.texi           cyd
Glenn Morris's avatar
Glenn Morris committed
230
package.texi      rgm
231
positions.texi    cyd
232
processes.texi    rgm
233
searching.texi    rgm
234
sequences.texi    cyd
235
streams.texi      cyd
236 237
strings.texi      cyd
symbols.texi      cyd
238
syntax.texi       cyd
Chong Yidong's avatar
Chong Yidong committed
239
text.texi         cyd
Glenn Morris's avatar
Glenn Morris committed
240
tips.texi         rgm
241
variables.texi    cyd
242
windows.texi      rgm (skimmed)
Chong Yidong's avatar
Chong Yidong committed
243

Kim F. Storm's avatar
Kim F. Storm committed
244 245 246

Local variables:
mode: outline
247
coding: utf-8
Kim F. Storm's avatar
Kim F. Storm committed
248
end: