2009-08-10 Kristian Rietveld <kris@lanedo.com>
[hildon:gtk.git] / README.commits
1 GTK+ is part of the GNOME Subversion repository. At the current time, any
2 person with write access to the GNOME repository, can make changes to
3 GTK+. This is a good thing, in that it encourages many people to work
4 on GTK+, and progress can be made quickly. However, GTK+ is a fairly
5 large and complicated package that many other things depend on, so to
6 avoid unnecessary breakage, and to take advantage of the knowledge
7 about GTK+ that has been built up over the last 4 years, we'd like
8 to ask people commiting to GTK+ to follow a few rules:
9
10 0) Ask first. If your changes are major, or could possibly break existing
11    code, you should always ask. If your change is minor and you've
12    been working on GTK+ for a while it probably isn't necessary
13    to ask. But when in doubt, ask. Even if your change is correct,
14    somebody may know a better way to do things.
15
16    If you are making changes to GTK+, you should be subscribed
17    to gtk-devel-list@gnome.org. (Subscription address:  
18    gtk-devel-list-request@gnome.org.) This is a good place to ask
19    about intended changes. 
20
21    #gtk+ on GIMPNet (irc.gimp.org, irc.us.gimp.org, irc.eu.gimp.org, ...)
22    is also a good place to find GTK+ developers to discuss changes with,
23    however, email to gtk-devel-list is the most certain and preferred
24    method.
25
26 1) Ask _first_.
27
28 2) There must be a ChangeLog for every commit. (If you discover that
29    you only committed half the files you meant to and need to fix that
30    up, or something, you don't need a new ChangeLog entry. But in general,
31    ChangeLog entries are mandatory.) Changes without ChangeLog entries
32    will be reverted.
33
34 3) There _must_ be a ChangeLog for every commit.
35
36 Notes:
37
38 * If you are going to be changing many files in an experimental fashion,
39   it probably is a good idea to create a separate branch for your changes.
40
41 * The ChangeLog entries should preferably match in date format
42   with the existing entries. You can set how emacs does this
43   by using customize mode:
44
45   - M-x customize
46   - set Programming/Tools/ChangeLog/Add Log Time Format to
47     'Old Format'
48
49  Or, set the add-log-time-format to 'current-time-string in
50  your .emacs file.
51
52 Owen Taylor
53 13 Aug 1998
54 17 Apr 2001