short and long log messages

[John Arbash Meinel]

Matthieu Moy wrote:
> Hi,

...

> 
> AFAIK, there is no such thing in bzr. Indeed, a user can use the first
> line of the log message as a short description, and the next as a long
> one. I think this is the way to do it, but this deserve a little support
> in bzr itself: the log formatter for "--line" and "--short" should split
> the message at the first newline, instead of truncating after a number
> of characters. The patch below does this for --line.
> 
> Also, this should be documented as such (in the tutorial probably).
> 
> Any opinion?
> 

I think it would be a reasonable best practices. Just like how we
document functions:

"""summary line.

more detailed stuff here
"""

And we could have log --line do this. But it might be better to follow
Alexander's suggestion and have a "log --log-format=summary", which
would just output the first line.

John
=:->

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 254 bytes
Desc: OpenPGP digital signature
Url : https://lists.ubuntu.com/archives/bazaar/attachments/20060517/67a0c13b/attachment.pgp