2004-06-20 21:50:53 +00:00
|
|
|
|
Tasks needed before the next release.
|
|
|
|
|
|
2005-04-01 01:44:36 +00:00
|
|
|
|
* TO BE DONE SHORTLY BEFORE RELEASE
|
2005-03-29 01:15:30 +00:00
|
|
|
|
|
2013-11-05 09:12:05 -08:00
|
|
|
|
** Either update, test, and support the old w32 build method, or remove it.
|
|
|
|
|
|
2009-07-11 03:06:44 +00:00
|
|
|
|
** Manuals
|
2013-08-13 00:04:10 -07:00
|
|
|
|
Check for node names using problematic characters:
|
|
|
|
|
find doc -name '*.texi' -exec grep '^@node[^,]*[:.()]' {} +
|
|
|
|
|
Sadly makeinfo does not warn about such characters.
|
|
|
|
|
|
2009-07-11 03:06:44 +00:00
|
|
|
|
Check cross-references between the manuals (eg from emacs to elisp)
|
2009-07-12 01:17:19 +00:00
|
|
|
|
are correct. You can use something like the following in the info
|
|
|
|
|
directory in the Emacs build tree:
|
|
|
|
|
|
2012-02-16 20:54:56 -08:00
|
|
|
|
emacs -Q --eval "(progn (require 'info) (setq Info-directory-list '(\".\")))" \
|
2009-07-12 01:17:19 +00:00
|
|
|
|
-f info-xref-check-all
|
2009-07-11 03:06:44 +00:00
|
|
|
|
|
2013-06-24 19:15:00 -07:00
|
|
|
|
Setting Info-directory-list avoids having system info pages confuse
|
|
|
|
|
things. References to external manuals will be flagged as
|
|
|
|
|
uncheckable. You should still check these, and also that each
|
|
|
|
|
external manual has an appropriate redirect in the file manual/.htaccess
|
|
|
|
|
in the web pages repository. E.g.:
|
|
|
|
|
Redirect /software/emacs/manual/html_mono/automake.html /software/automake/manual/automake.html
|
|
|
|
|
Redirect /software/emacs/manual/html_node/automake/ /software/automake/manual/html_node/
|
|
|
|
|
|
2013-07-03 19:30:36 -07:00
|
|
|
|
Another tool you can use to check links is gnu.org's linc.py:
|
|
|
|
|
http://www.gnu.org/server/source/
|
|
|
|
|
|
|
|
|
|
You run this something like:
|
|
|
|
|
|
|
|
|
|
cd /path/to/cvs/emacs-www
|
|
|
|
|
linc.py -o /path/to/output-dir --url http://www.gnu.org/software/emacs/ .
|
|
|
|
|
|
|
|
|
|
Be warned that it is really, really slow (as in, can take ~ a full day
|
|
|
|
|
to check the manual/ directory). It is probably best to run it on a
|
|
|
|
|
single directory at a time from eg manual/html_node. It is very
|
|
|
|
|
inefficient, but may reveal a few things that info-xref does not.
|
|
|
|
|
|
|
|
|
|
|
2009-07-11 03:06:44 +00:00
|
|
|
|
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.
|
|
|
|
|
|
2009-07-11 19:55:19 +00:00
|
|
|
|
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.
|
2012-05-07 23:44:18 -07:00
|
|
|
|
(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").
|
2005-06-20 03:22:38 +00:00
|
|
|
|
|
2009-07-16 03:30:31 +00:00
|
|
|
|
** Check the keybindings in the refcards are correct, and add any new ones.
|
|
|
|
|
What paper size are the English versions supposed to be on?
|
2009-07-16 03:28:04 +00:00
|
|
|
|
On Debian testing, the packages texlive-lang-czechslovak and
|
|
|
|
|
texlive-lang-polish will let you generate the cs-* and sk-* pdfs.
|
2012-04-30 00:46:03 -07:00
|
|
|
|
(You may need texlive-lang-cyrillic, texlive-lang-german for others.)
|
2009-07-16 03:28:04 +00:00
|
|
|
|
The Makefile rules did not work for me, I had to use something like:
|
|
|
|
|
csplain -output-format=pdf cs-refcard
|
2007-02-27 04:02:27 +00:00
|
|
|
|
|
2005-07-07 22:57:21 +00:00
|
|
|
|
** Ask maintainers of refcard translations to update them.
|
|
|
|
|
|
2007-10-06 01:52:18 +00:00
|
|
|
|
Emacs 22 translators:
|
2006-05-24 16:48:15 +00:00
|
|
|
|
|
|
|
|
|
LANG Translator Status
|
2007-10-06 01:52:18 +00:00
|
|
|
|
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
|
2006-05-24 16:48:15 +00:00
|
|
|
|
|
2012-04-19 21:03:55 -07:00
|
|
|
|
** For a major release, add a "New in Emacs XX" section to faq.texi.
|
|
|
|
|
|
2007-05-05 22:47:02 +00:00
|
|
|
|
** Remove temporary +++/--- lines in NEWS.
|
|
|
|
|
|
|
|
|
|
** Try to reorder NEWS: most important things first, related items together.
|
|
|
|
|
|
2009-07-11 03:06:44 +00:00
|
|
|
|
** Consider bumping customize-changed-options-previous-release.
|
|
|
|
|
|
2012-04-20 17:36:34 -04:00
|
|
|
|
** cusver-check from admin.el can help find new defcustoms missing
|
2012-04-19 21:03:55 -07:00
|
|
|
|
:version tags.
|
|
|
|
|
|
2006-08-25 21:08:44 +00:00
|
|
|
|
* BUGS
|
|
|
|
|
|
2008-12-22 01:30:31 +00:00
|
|
|
|
** 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).
|
|
|
|
|
|
2009-11-30 16:11:18 +00:00
|
|
|
|
3. `center-line' in Text mode was already moved to the text formatting
|
2008-12-22 01:30:31 +00:00
|
|
|
|
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').
|
|
|
|
|
|
2009-11-30 16:11:18 +00:00
|
|
|
|
4. PCL-CVS binds `M-s' to `cvs-status', and log-edit-mode binds it to
|
2008-12-22 01:30:31 +00:00
|
|
|
|
`log-edit-comment-search-forward'. Perhaps search commands
|
|
|
|
|
on the global key binding `M-s' are useless in these modes.
|
|
|
|
|
|
2012-02-18 19:39:04 -08:00
|
|
|
|
5. Rmail binds `\es' to `rmail-search'/`rmail-summary-search'.
|
|
|
|
|
|
|
|
|
|
|
2008-09-05 06:53:31 +00:00
|
|
|
|
* DOCUMENTATION
|
2008-02-02 01:16:50 +00:00
|
|
|
|
|
2005-03-31 15:20:45 +00:00
|
|
|
|
** Check the Emacs Tutorial.
|
|
|
|
|
|
2006-09-30 21:20:20 +00:00
|
|
|
|
The first line of every tutorial must begin with text ending in a
|
|
|
|
|
period (".", ASCII 0x2E) saying "Emacs Tutorial" in the respective
|
2007-09-21 04:06:09 +00:00
|
|
|
|
language. This should be followed by "See end for copying conditions",
|
|
|
|
|
likewise in the respective language.
|
2005-04-01 15:42:23 +00:00
|
|
|
|
|
|
|
|
|
After each file name, on the same line or the following line, come the
|
|
|
|
|
names of the people who have checked it.
|
|
|
|
|
|
2005-03-31 15:20:45 +00:00
|
|
|
|
SECTION READERS
|
|
|
|
|
----------------------------------
|
2012-01-10 16:27:22 +08:00
|
|
|
|
TUTORIAL cyd
|
2012-01-21 22:58:38 +08:00
|
|
|
|
TUTORIAL.bg ogi
|
2013-09-20 18:22:20 +08:00
|
|
|
|
TUTORIAL.cn xfq
|
2011-07-19 00:15:15 -07:00
|
|
|
|
TUTORIAL.cs
|
2012-01-21 22:58:38 +08:00
|
|
|
|
TUTORIAL.de wl
|
2011-07-19 00:15:15 -07:00
|
|
|
|
TUTORIAL.eo
|
|
|
|
|
TUTORIAL.es
|
|
|
|
|
TUTORIAL.fr
|
2012-01-14 13:23:45 +02:00
|
|
|
|
TUTORIAL.he eliz
|
2011-07-19 00:15:15 -07:00
|
|
|
|
TUTORIAL.it
|
2013-09-20 18:22:20 +08:00
|
|
|
|
TUTORIAL.ja
|
2011-07-19 00:15:15 -07:00
|
|
|
|
TUTORIAL.ko
|
2012-02-04 22:56:32 +08:00
|
|
|
|
TUTORIAL.nl Pieter Schoenmakers
|
2011-07-19 00:15:15 -07:00
|
|
|
|
TUTORIAL.pl
|
|
|
|
|
TUTORIAL.pt_BR
|
|
|
|
|
TUTORIAL.ro
|
2012-02-08 10:05:02 +08:00
|
|
|
|
TUTORIAL.ru Alex Ott
|
2011-07-19 00:15:15 -07:00
|
|
|
|
TUTORIAL.sk
|
2012-01-17 22:16:42 +08:00
|
|
|
|
TUTORIAL.sl Primoz PETERLIN
|
2012-01-25 14:12:10 +08:00
|
|
|
|
TUTORIAL.sv Mats Lidell
|
2011-07-19 00:15:15 -07:00
|
|
|
|
TUTORIAL.th
|
|
|
|
|
TUTORIAL.zh
|
2005-03-31 15:20:45 +00:00
|
|
|
|
|
2008-06-26 17:50:48 +00:00
|
|
|
|
** Check the manual.
|
|
|
|
|
|
2011-12-26 18:36:41 +08:00
|
|
|
|
abbrevs.texi cyd
|
2012-02-20 16:26:56 -08:00
|
|
|
|
ack.texi rgm
|
2012-01-25 13:48:11 +08:00
|
|
|
|
anti.texi cyd
|
2011-10-21 22:45:34 +08:00
|
|
|
|
arevert-xtra.texi cyd
|
2011-10-15 12:37:45 -04:00
|
|
|
|
basic.texi cyd
|
2011-10-23 22:57:53 +08:00
|
|
|
|
buffers.texi cyd
|
2011-12-19 15:25:46 +08:00
|
|
|
|
building.texi cyd
|
2012-02-16 20:28:53 -08:00
|
|
|
|
calendar.texi rgm
|
2012-02-17 22:02:12 -05:00
|
|
|
|
cal-xtra.texi rgm
|
2012-01-14 17:17:25 +08:00
|
|
|
|
cmdargs.texi cyd
|
2011-10-07 12:22:04 -04:00
|
|
|
|
commands.texi cyd
|
2012-01-06 18:53:41 +08:00
|
|
|
|
custom.texi cyd
|
2011-12-26 18:36:41 +08:00
|
|
|
|
dired.texi cyd
|
2012-02-15 23:15:27 -08:00
|
|
|
|
dired-xtra.texi rgm
|
2011-10-18 17:11:17 -04:00
|
|
|
|
display.texi cyd
|
2012-02-20 15:50:52 -08:00
|
|
|
|
emacs.texi rgm
|
2012-02-21 14:56:14 -05:00
|
|
|
|
emacs-xtra.texi rgm
|
2012-02-21 16:43:51 -05:00
|
|
|
|
emerge-xtra.texi rgm
|
2011-10-07 12:22:04 -04:00
|
|
|
|
entering.texi cyd
|
2011-10-21 22:45:34 +08:00
|
|
|
|
files.texi cyd
|
2012-01-15 23:26:39 +08:00
|
|
|
|
fixit.texi cyd
|
2012-02-15 22:53:50 -08:00
|
|
|
|
fortran-xtra.texi rgm
|
2011-11-28 14:24:48 +08:00
|
|
|
|
frames.texi cyd
|
2012-04-04 00:27:17 -07:00
|
|
|
|
glossary.texi rgm
|
2011-10-15 12:37:45 -04:00
|
|
|
|
help.texi cyd
|
2011-11-28 19:12:00 +08:00
|
|
|
|
indent.texi cyd
|
2011-10-15 12:37:45 -04:00
|
|
|
|
killing.texi cyd
|
2011-10-21 22:45:34 +08:00
|
|
|
|
kmacro.texi cyd
|
2012-02-22 00:16:48 -08:00
|
|
|
|
macos.texi rgm (can't actually test any of it though)
|
2011-12-25 22:16:00 +08:00
|
|
|
|
maintaining.texi cyd
|
2011-10-15 12:37:45 -04:00
|
|
|
|
mark.texi cyd
|
2012-02-23 00:32:18 -08:00
|
|
|
|
mini.texi rgm
|
2012-01-03 16:55:00 +08:00
|
|
|
|
misc.texi cyd
|
2011-11-28 14:24:48 +08:00
|
|
|
|
modes.texi cyd
|
2012-02-22 21:36:08 -08:00
|
|
|
|
msdog.texi rgm (can't actually test any of it though)
|
2012-02-22 20:32:18 -08:00
|
|
|
|
msdog-xtra.texi rgm (can't actually test any of it though)
|
2012-04-14 12:20:25 -07:00
|
|
|
|
mule.texi rgm (not 100% sure about "Fontsets")
|
2011-10-15 12:37:45 -04:00
|
|
|
|
m-x.texi cyd
|
2012-01-05 19:09:27 +08:00
|
|
|
|
package.texi cyd
|
2012-02-21 09:09:19 -08:00
|
|
|
|
picture-xtra.texi rgm
|
2011-12-19 15:25:46 +08:00
|
|
|
|
programs.texi cyd
|
2011-10-15 12:37:45 -04:00
|
|
|
|
regs.texi cyd
|
2012-02-18 13:57:00 -08:00
|
|
|
|
rmail.texi rgm
|
2011-10-07 12:22:04 -04:00
|
|
|
|
screen.texi cyd
|
2011-10-19 00:21:52 -04:00
|
|
|
|
search.texi cyd
|
2011-12-30 18:19:42 +08:00
|
|
|
|
sending.texi cyd
|
2011-12-19 15:25:46 +08:00
|
|
|
|
text.texi cyd
|
2012-01-07 11:15:48 +08:00
|
|
|
|
trouble.texi cyd
|
2011-12-25 22:16:00 +08:00
|
|
|
|
vc-xtra.texi cyd
|
|
|
|
|
vc1-xtra.texi cyd
|
2011-11-28 14:24:48 +08:00
|
|
|
|
windows.texi cyd
|
2012-01-15 23:26:39 +08:00
|
|
|
|
xresources.texi cyd
|
2008-06-26 17:50:48 +00:00
|
|
|
|
|
|
|
|
|
** Check the Lisp manual.
|
|
|
|
|
|
2012-03-03 18:45:04 -08:00
|
|
|
|
abbrevs.texi rgm
|
2012-02-10 23:50:11 +08:00
|
|
|
|
advice.texi cyd
|
2012-04-14 13:43:11 -07:00
|
|
|
|
anti.texi rgm
|
2012-03-31 12:58:05 -07:00
|
|
|
|
back.texi rgm
|
2012-02-25 17:32:33 +08:00
|
|
|
|
backups.texi cyd
|
2012-02-27 15:26:13 +08:00
|
|
|
|
buffers.texi cyd
|
2012-02-12 17:51:03 +08:00
|
|
|
|
commands.texi cyd
|
2012-02-10 23:50:11 +08:00
|
|
|
|
compile.texi cyd
|
2012-01-23 12:23:50 +08:00
|
|
|
|
control.texi cyd
|
2012-02-05 22:27:06 +08:00
|
|
|
|
customize.texi cyd
|
2012-02-12 17:51:03 +08:00
|
|
|
|
debugging.texi cyd
|
2012-03-31 00:31:24 +08:00
|
|
|
|
display.texi cyd
|
2012-03-31 12:58:05 -07:00
|
|
|
|
edebug.texi rgm
|
2008-06-26 17:50:48 +00:00
|
|
|
|
elisp.texi
|
2012-02-25 12:59:46 -08:00
|
|
|
|
errors.texi rgm
|
2012-01-23 12:23:50 +08:00
|
|
|
|
eval.texi cyd
|
2012-02-21 21:24:48 +08:00
|
|
|
|
files.texi cyd
|
Update Frames chapter of Lisp manager. Document clipboard manager.
* doc/emacs/killing.texi (Clipboard): Document clipboard manager.
* doc/lispref/windows.texi (Basic Windows, Coordinates and Windows)
(Coordinates and Windows):
* display.texi (Refresh Screen, Line Height, Face Attributes)
(Overlay Arrow, Beeping, Glyphless Chars): Likewise.
* doc/lispref/frames.texi (Frames): Remove little-used "terminal frame" and
"window frame" terminology.
(Frame Parameters, Font and Color Parameters, Initial Parameters)
(Size and Position, Visibility of Frames): Callers changed.
(Frames): Clarify which terminals in framep are graphical.
(Initial Parameters): --geometry is not the only option which adds
to initial-frame-alist.
(Position Parameters): Note that icon-left and icon-top are for
old window managers only.
(Size Parameters): Sizes are in characters even on graphical
displays.
(Management Parameters): Note that window-id and outer-window-id
can't really be changed, and that auto-raise isn't always obeyed.
(Cursor Parameters): Document cursor-type explicitly.
(Size and Position): The aliases set-screen-height and
set-screen-width have been deleted.
(Visibility of Frames): Mention "minimization".
* doc/lispref/os.texi (Startup Summary): Minor clarifications.
(Startup Summary, Suspending Emacs): Standardize on "text
terminal" terminology.
2012-03-04 14:50:18 +08:00
|
|
|
|
frames.texi cyd
|
2012-02-04 22:56:32 +08:00
|
|
|
|
functions.texi cyd
|
2012-01-23 12:23:50 +08:00
|
|
|
|
hash.texi cyd
|
2012-02-19 13:54:33 +08:00
|
|
|
|
help.texi cyd
|
2012-03-01 21:52:40 -05:00
|
|
|
|
hooks.texi rgm
|
2008-06-26 17:50:48 +00:00
|
|
|
|
index.texi
|
2012-03-18 23:02:12 +08:00
|
|
|
|
internals.texi rgm cyd
|
2012-01-17 22:16:42 +08:00
|
|
|
|
intro.texi cyd
|
2012-02-15 00:41:16 +08:00
|
|
|
|
keymaps.texi cyd
|
2012-01-23 12:23:50 +08:00
|
|
|
|
lists.texi cyd
|
2012-02-10 15:57:21 +08:00
|
|
|
|
loading.texi cyd
|
2012-02-05 14:44:47 +08:00
|
|
|
|
macros.texi cyd
|
2012-02-29 23:29:48 -08:00
|
|
|
|
maps.texi rgm
|
2012-03-07 00:38:05 -08:00
|
|
|
|
markers.texi rgm
|
2012-04-19 21:03:55 -07:00
|
|
|
|
minibuf.texi rgm
|
2012-02-19 13:54:33 +08:00
|
|
|
|
modes.texi cyd
|
2012-03-10 11:27:10 +08:00
|
|
|
|
nonascii.texi cyd
|
2012-01-23 12:23:50 +08:00
|
|
|
|
numbers.texi cyd
|
2012-01-21 22:58:38 +08:00
|
|
|
|
objects.texi cyd
|
2012-03-18 23:02:12 +08:00
|
|
|
|
os.texi cyd
|
2012-03-06 20:58:30 -05:00
|
|
|
|
package.texi rgm
|
2012-03-05 14:12:17 +08:00
|
|
|
|
positions.texi cyd
|
2012-04-18 00:21:18 -07:00
|
|
|
|
processes.texi rgm
|
2012-03-28 12:30:12 -07:00
|
|
|
|
searching.texi rgm
|
2012-01-23 12:23:50 +08:00
|
|
|
|
sequences.texi cyd
|
2012-02-12 17:51:03 +08:00
|
|
|
|
streams.texi cyd
|
2012-01-23 12:23:50 +08:00
|
|
|
|
strings.texi cyd
|
|
|
|
|
symbols.texi cyd
|
2012-02-16 22:43:41 +08:00
|
|
|
|
syntax.texi cyd
|
2012-03-10 11:27:10 +08:00
|
|
|
|
text.texi cyd
|
2012-03-02 20:29:55 -05:00
|
|
|
|
tips.texi rgm
|
2012-02-04 22:56:32 +08:00
|
|
|
|
variables.texi cyd
|
2012-04-21 12:31:05 -07:00
|
|
|
|
windows.texi rgm (skimmed)
|
2008-06-26 17:50:48 +00:00
|
|
|
|
|
2004-06-28 09:03:00 +00:00
|
|
|
|
|
|
|
|
|
Local variables:
|
|
|
|
|
mode: outline
|
2006-05-24 16:48:15 +00:00
|
|
|
|
coding: utf-8
|
2004-06-28 09:03:00 +00:00
|
|
|
|
end:
|