Re: [ros-dev] Commit log

[Colin Finck]

Matthias Kupfer wrote:
>   - we introduce an additional prefix for a commit
> message line 
>  to mark a changelog entry 
Ok, that's what KJK's suggestion was also about.


>   - the prefix is "[CL]" for a general entry
> or 
>  "[CL:cat1:cat2:cat3]" for an 
>  hierarchical categorization cat1 -> cat2 -> cat3 aso. 
Ok, as long as this hierarchical categorization is just limited to subitems
of .rbuild modules (i.e. [ntoskrnl:io]).
I don't think that modules like [winemine] should get any extra hierarchical
structure, that would only make them too clumsy. Additionally, we can still
decide later, into which top-level categories these modules belong to.


>   - we limit the changelog to one line - we can generate
>
>  several entries with one commit message (by using multiple changelog 
lines)

Well, I'd appreciate if something like the following would also be possible:

---------------------------------------------------------------
[winemine] Fixed this.
It had a terrible bug.

[user32] Same thing here.

Arch, what the hell did you do?!
---------------------------------------------------------------

The separator between the changelog entry and the detailed commit
message/Arch bashing would be one empty line then as long as no other prefix
follows.

But well, after all, I don't see many differences from your suggestion to
KJK's one.
And good old ROS philosophy taught us that we should not waste time on long
discussions about minor details, so let's soon agree on a common proposal
and ask for votes from the other developers.

Best regards,

Colin