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