Merge from emacs-24; up to 2014-05-29T17:16:00Z!dmantipov@yandex.ru
[bpt/emacs.git] / admin / notes / changelogs
1 Emacs generally follows the GNU coding standards when it comes to ChangeLogs:
2 http://www.gnu.org/prep/standards/html_node/Change-Logs.html
3
4 One exception is that we still sometimes quote `like-this' (as the
5 standards used to recommend) rather than 'like-this' (as they do now),
6 because `...' is so widely used elsewhere in Emacs.
7 http://lists.gnu.org/archive/html/emacs-devel/2014-05/msg00514.html
8
9
10 If installing changes written by someone else, make the ChangeLog
11 entry in their name, not yours.
12
13
14 http://lists.gnu.org/archive/html/emacs-devel/2007-09/msg00793.html
15 There is no need to make change log entries for files such as NEWS,
16 MAINTAINERS, and FOR-RELEASE.
17 "There is no need" means you don't have to, but you can if you want to.
18
19
20 http://lists.gnu.org/archive/html/emacs-devel/2006-12/msg01135.html
21 There is no need to indicate regeneration of files such as configure
22 in ChangeLog.
23
24
25 http://lists.gnu.org/archive/html/emacs-devel/2008-11/msg00940.html
26 Preferred form for several entries with the same content:
27
28 * help.el (view-lossage):
29 * kmacro.el (kmacro-edit-lossage):
30 * edmacro.el (edit-kbd-macro): Fix docstring, lossage is now 300 keys.
31
32 (Rather than anything involving "ditto" and suchlike.)