wiki:CommitMessages

Version 1 (modified by mkae (Marko Käning), 10 years ago) (diff)

Formulate rule for commit messages to MacPorts' SVN repo

Commit Rules

Using sensible commit messages

When committing your changes to MacPorts' central port tree using subversion it is good practice to use properly formatted commit messages.

Think about others reading the timeline. Here you want to see on first glance which port got modified, therefore the required format for commit messages is this:

PORTNAME: COMMENT

Here a reader of MacPorts' timeline can see quickly get the most important information, i.e. WHICH port got changed WHY.

A real-life example is:

devel/zmq: Fix build on darwin <= 10, closes #40663

Note that references to trac tickets can be inserted using the '#' as well as references to certain commits of the MacPorts repository by using 'r' (e.g. r111866).