[Frugalware-devel] about multiline long comments

[Christian Hamar [krix]]

2007. 06. 5, kedd keltezéssel 11.52-kor VMiklos ezt írta:
> hi,
> 
> almost every dev has its own style regarding multiline long comments
> 
> Alex:
> Sun Jun  3 16:19:13 CEST 2007  AlexExtreme <alex at alex-smith.me.uk>
>   * gedit-2.18.1-2-i686
>    * Removed unnecessary eel depend (closes #2109)
> 
> (prefix: ' * ')
> 
> krix:
> Sun Jun  3 15:30:02 CEST 2007  Christian Hamar alias krix <krics at linuxforum.hu>
>   * imagemagick-6.3.4_5-1-x86_64
>     * Version bump
> 
> (prefix: '  * ')

I prefer my way :D hehe. Because if you see my version and Alex's
version then maybe my version if better readable. Just my 2 cent.

> crazy:
> Sun Jun  3 13:45:51 CEST 2007  crazy <crazy at frugalware.org>
>   * php-5.2.3-2-i686
>   * fixes for SMP builds , make is fine with SMP just make install is
>   * broken
>   * fixed php-cgi , reported by janny
> 
> (prefix: '* ')

I dont like this, because there is no "seperation" between the package
name-version-release and the rest of changes. I think the first line
should be "seperated" because its better to read the changelog.

> ironiq:
> Tue May 29 16:00:28 CEST 2007  Krisztian VASAS <iron at frugalware.org>
>   * rrdtool-1.2.23-1-i686
>   - version bump
> (prefix: '- ')

This is better than crazy's one because there isn't * the beginning
line, which cause that the changelog easly readable.

> myself:
> Sun Jun  3 13:33:07 CEST 2007  VMiklos <vmiklos at frugalware.org>
>   * glibc-2.6-3-i686
>   rebuilt using --enable-kernel=2.6.0
>   closes #2104
> 
> (no prefix)

Same as crazy's one. There is no * but seems a bit messy. :)

Regards
-krix-