Commit | Line | Data |
---|---|---|
e47ac727 RS |
1 | Tasks needed before the next release. |
2 | ||
c8de0427 | 3 | * TO BE DONE SHORTLY BEFORE RELEASE |
1f912e99 | 4 | |
10a99e0d GM |
5 | ** Manuals |
6 | Check cross-references between the manuals (eg from emacs to elisp) | |
332eb5f1 GM |
7 | are correct. You can use something like the following in the info |
8 | directory in the Emacs build tree: | |
9 | ||
bcc65704 | 10 | emacs -Q --eval "(progn (require 'info) (setq Info-directory-list '(\".\")))" \ |
332eb5f1 | 11 | -f info-xref-check-all |
10a99e0d GM |
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 | ||
64adbcf6 GM |
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. | |
e2866686 GM |
34 | (Actually, there is probably little point in trying to do this. |
35 | It's only really relevant if printed versions of the manuals are going | |
36 | to be published. End-users are not likely to print out all 1000+ | |
37 | pages of the manuals, and even if they do, the resulting page breaks | |
38 | depend on what paper and font size they use. This also means that if | |
39 | you _are_ going to do this, it should be done with the paper and font | |
40 | size that the GNU Press are going to use when they print the manuals. | |
41 | I think this is different to what you get if you just use eg `make | |
42 | emacs.pdf' (e.g., enable "smallbook"). | |
059cbcd5 | 43 | |
6ad032d2 GM |
44 | ** Check the keybindings in the refcards are correct, and add any new ones. |
45 | Regenerate the pdf versions in etc/refcards/. | |
46 | What paper size are the English versions supposed to be on? | |
accc7588 GM |
47 | On Debian testing, the packages texlive-lang-czechslovak and |
48 | texlive-lang-polish will let you generate the cs-* and sk-* pdfs. | |
a017d05f | 49 | (You may need texlive-lang-cyrillic, texlive-lang-german for others.) |
accc7588 GM |
50 | The Makefile rules did not work for me, I had to use something like: |
51 | csplain -output-format=pdf cs-refcard | |
f199f76c | 52 | |
b713c813 RS |
53 | ** Ask maintainers of refcard translations to update them. |
54 | ||
590394eb | 55 | Emacs 22 translators: |
49561a36 RS |
56 | |
57 | LANG Translator Status | |
590394eb GM |
58 | cs Pavel Janík |
59 | de Sven Joachim | |
60 | fr Eric Jacoboni | |
61 | pl Włodek Bzyl | |
62 | pt-br Rodrigo Real | |
63 | ru Alex Ott | |
64 | sk Miroslav Vaško | |
49561a36 | 65 | |
5db6195f GM |
66 | ** For a major release, add a "New in Emacs XX" section to faq.texi. |
67 | ||
0fd352a5 GM |
68 | ** Remove temporary +++/--- lines in NEWS. |
69 | ||
70 | ** Try to reorder NEWS: most important things first, related items together. | |
71 | ||
10a99e0d GM |
72 | ** Consider bumping customize-changed-options-previous-release. |
73 | ||
8cee47b8 | 74 | ** cusver-check from admin.el can help find new defcustoms missing |
5db6195f GM |
75 | :version tags. |
76 | ||
f9de7738 RS |
77 | * BUGS |
78 | ||
caf857eb JL |
79 | ** Check for modes which bind M-s that conflicts with a new global binding M-s |
80 | and change key bindings where necessary. The current list of modes: | |
81 | ||
82 | 1. Gnus binds `M-s' to `gnus-summary-search-article-forward'. | |
83 | ||
84 | 2. Minibuffer binds `M-s' to `next-matching-history-element' | |
85 | (not useful any more since C-s can now search in the history). | |
86 | ||
1f9689eb | 87 | 3. `center-line' in Text mode was already moved to the text formatting |
caf857eb JL |
88 | keymap as `M-o M-s' (thus this binding is not necessary any more |
89 | in `nroff-mode-map' too and can be removed now from the nroff mode | |
90 | because it can now use the global key binding `M-o M-s' `center-line'). | |
91 | ||
1f9689eb | 92 | 4. PCL-CVS binds `M-s' to `cvs-status', and log-edit-mode binds it to |
caf857eb JL |
93 | `log-edit-comment-search-forward'. Perhaps search commands |
94 | on the global key binding `M-s' are useless in these modes. | |
95 | ||
8f4fb15f GM |
96 | 5. Rmail binds `\es' to `rmail-search'/`rmail-summary-search'. |
97 | ||
98 | ||
3026f1b4 | 99 | * DOCUMENTATION |
58340fa7 | 100 | |
0b048d52 MT |
101 | ** Check the Emacs Tutorial. |
102 | ||
29121f81 RS |
103 | The first line of every tutorial must begin with text ending in a |
104 | period (".", ASCII 0x2E) saying "Emacs Tutorial" in the respective | |
41999d0f GM |
105 | language. This should be followed by "See end for copying conditions", |
106 | likewise in the respective language. | |
b75122e4 RS |
107 | |
108 | After each file name, on the same line or the following line, come the | |
109 | names of the people who have checked it. | |
110 | ||
0b048d52 MT |
111 | SECTION READERS |
112 | ---------------------------------- | |
107ddb97 | 113 | TUTORIAL cyd |
7a22e700 | 114 | TUTORIAL.bg ogi |
fd99fde6 GM |
115 | TUTORIAL.cn |
116 | TUTORIAL.cs | |
7a22e700 | 117 | TUTORIAL.de wl |
fd99fde6 GM |
118 | TUTORIAL.eo |
119 | TUTORIAL.es | |
120 | TUTORIAL.fr | |
0dc18ae0 | 121 | TUTORIAL.he eliz |
fd99fde6 GM |
122 | TUTORIAL.it |
123 | TUTORIAL.ja | |
124 | TUTORIAL.ko | |
735cc5ca | 125 | TUTORIAL.nl Pieter Schoenmakers |
fd99fde6 GM |
126 | TUTORIAL.pl |
127 | TUTORIAL.pt_BR | |
128 | TUTORIAL.ro | |
5eb7536f | 129 | TUTORIAL.ru Alex Ott |
fd99fde6 | 130 | TUTORIAL.sk |
6d0bd9ba | 131 | TUTORIAL.sl Primoz PETERLIN |
21f50183 | 132 | TUTORIAL.sv Mats Lidell |
fd99fde6 GM |
133 | TUTORIAL.th |
134 | TUTORIAL.zh | |
0b048d52 | 135 | |
01c29e98 CY |
136 | ** Check the manual. |
137 | ||
c40a7de7 | 138 | abbrevs.texi cyd |
41f1e868 | 139 | ack.texi rgm |
0b21c100 | 140 | anti.texi cyd |
bfd779dd | 141 | arevert-xtra.texi cyd |
21100e7d | 142 | basic.texi cyd |
da97a9e6 | 143 | buffers.texi cyd |
bc859d5f | 144 | building.texi cyd |
112d1241 | 145 | calendar.texi rgm |
a5987767 | 146 | cal-xtra.texi rgm |
a73a3461 | 147 | cmdargs.texi cyd |
de0bde62 | 148 | commands.texi cyd |
89bd9ccd | 149 | custom.texi cyd |
c40a7de7 | 150 | dired.texi cyd |
3b19a30d | 151 | dired-xtra.texi rgm |
939db9ac | 152 | display.texi cyd |
2d2f6581 | 153 | emacs.texi rgm |
2e03845d | 154 | emacs-xtra.texi rgm |
68af8d4f | 155 | emerge-xtra.texi rgm |
de0bde62 | 156 | entering.texi cyd |
bfd779dd | 157 | files.texi cyd |
06848b82 | 158 | fixit.texi cyd |
d400b295 | 159 | fortran-xtra.texi rgm |
dc95a8b0 | 160 | frames.texi cyd |
a0706406 | 161 | glossary.texi rgm |
21100e7d | 162 | help.texi cyd |
6d262977 | 163 | indent.texi cyd |
21100e7d | 164 | killing.texi cyd |
bfd779dd | 165 | kmacro.texi cyd |
40ace058 | 166 | macos.texi rgm (can't actually test any of it though) |
3d992aa0 | 167 | maintaining.texi cyd |
21100e7d | 168 | mark.texi cyd |
49fe4321 | 169 | mini.texi rgm |
88c5c7c8 | 170 | misc.texi cyd |
dc95a8b0 | 171 | modes.texi cyd |
8f4042d2 | 172 | msdog.texi rgm (can't actually test any of it though) |
371fb833 | 173 | msdog-xtra.texi rgm (can't actually test any of it though) |
05806f43 | 174 | mule.texi rgm (not 100% sure about "Fontsets") |
21100e7d | 175 | m-x.texi cyd |
b0d7d8af | 176 | package.texi cyd |
5f8dc2ca | 177 | picture-xtra.texi rgm |
bc859d5f | 178 | programs.texi cyd |
21100e7d | 179 | regs.texi cyd |
b474519e | 180 | rmail.texi rgm |
de0bde62 | 181 | screen.texi cyd |
5abc31ef | 182 | search.texi cyd |
b30941db | 183 | sending.texi cyd |
bc859d5f | 184 | text.texi cyd |
c61ab18c | 185 | trouble.texi cyd |
3d992aa0 CY |
186 | vc-xtra.texi cyd |
187 | vc1-xtra.texi cyd | |
dc95a8b0 | 188 | windows.texi cyd |
06848b82 | 189 | xresources.texi cyd |
01c29e98 CY |
190 | |
191 | ** Check the Lisp manual. | |
192 | ||
ea16568d | 193 | abbrevs.texi rgm |
25dec365 | 194 | advice.texi cyd |
764a3017 | 195 | anti.texi rgm |
0b021094 | 196 | back.texi rgm |
d268b4fe | 197 | backups.texi cyd |
431ee44b | 198 | buffers.texi cyd |
faccede1 | 199 | commands.texi cyd |
25dec365 | 200 | compile.texi cyd |
31cbea1d | 201 | control.texi cyd |
e1161b06 | 202 | customize.texi cyd |
faccede1 | 203 | debugging.texi cyd |
5319014e | 204 | display.texi cyd |
0b021094 | 205 | edebug.texi rgm |
01c29e98 | 206 | elisp.texi |
7e05b1ec | 207 | errors.texi rgm |
31cbea1d | 208 | eval.texi cyd |
a59225b1 | 209 | files.texi cyd |
a08a07e3 | 210 | frames.texi cyd |
735cc5ca | 211 | functions.texi cyd |
31cbea1d | 212 | hash.texi cyd |
8376d7c2 | 213 | help.texi cyd |
2064cc6a | 214 | hooks.texi rgm |
01c29e98 | 215 | index.texi |
d15aac68 | 216 | internals.texi rgm cyd |
6d0bd9ba | 217 | intro.texi cyd |
3d8badf4 | 218 | keymaps.texi cyd |
31cbea1d | 219 | lists.texi cyd |
6c1e4b46 | 220 | loading.texi cyd |
03988c98 | 221 | macros.texi cyd |
53a1239b | 222 | maps.texi rgm |
3266b56f | 223 | markers.texi rgm |
5db6195f | 224 | minibuf.texi rgm |
8376d7c2 | 225 | modes.texi cyd |
83ef8187 | 226 | nonascii.texi cyd |
31cbea1d | 227 | numbers.texi cyd |
7a22e700 | 228 | objects.texi cyd |
d15aac68 | 229 | os.texi cyd |
763d4948 | 230 | package.texi rgm |
ef959d3a | 231 | positions.texi cyd |
4373fd43 | 232 | processes.texi rgm |
fee88ca0 | 233 | searching.texi rgm |
31cbea1d | 234 | sequences.texi cyd |
faccede1 | 235 | streams.texi cyd |
31cbea1d CY |
236 | strings.texi cyd |
237 | symbols.texi cyd | |
4230351b | 238 | syntax.texi cyd |
83ef8187 | 239 | text.texi cyd |
b3134b95 | 240 | tips.texi rgm |
735cc5ca | 241 | variables.texi cyd |
09ebefe1 | 242 | windows.texi rgm (skimmed) |
01c29e98 | 243 | |
c0a070c1 KS |
244 | \f |
245 | Local variables: | |
246 | mode: outline | |
49561a36 | 247 | coding: utf-8 |
c0a070c1 | 248 | end: |