On Fri, 2006-04-28 at 12:38, Bryan O'Sullivan wrote:
> It's a common practice to have the first line of a changeset description
> stand alone, and to make that the "Subject:" of a change notification.

The long-established practice for solaris's ON consolidation is to put
the details into the bug database and ARC repositories so the
putback/commit comments tend to be concise.

To cite a recent example:

PSARC 2006/153 Zones ZFS Integration
6383119 RFE: add support for using zfs clones when cloning a zone
6405233 attaching a zone to a system with multiple versions of a patch
with one version higher succeeds
6365776 zoneadm uninstall doesn't remove <zonepath>/lu
6400688 Cannot clone a zone with AF_UNIX sockets

We have tools which can postprocess the bugids into hyperlinks, but the
first line isn't special; you can have 0 to many ARC cases and 1 to many
bugids fixed.

> Then you spend a while beating up people who don't follow the convention
> (with first lines like "Fix the bug where the") until they get it :-)

at least for the ON consolidation the current developer community has
been bludgeoned into the above form..

                                                - Bill


_______________________________________________
tools-discuss mailing list
[email protected]

Reply via email to