changelog format

Björn Persson bjorn at xn--rombobjrn-67a.se
Wed Apr 22 00:36:43 UTC 2009


Pierre-Yves wrote:
> On Tue, 2009-04-21 at 03:25 +0200, Kevin Kofler wrote:
> > The format is fairly straightforward:
> >
> > * first line (elements separated by spaces):
> >   - asterisk
> >   - date in Wkd Mth dd yyyy format (e.g. Mon Apr 21 2009)
> >     (if the day is just 1 digit, you can write any of "1", " 1" or "01")
> >   - your name
> >   - your e-mail address between angle brackets ('<' and '>')
> >   - optionally a dash
> >   - the EVR (Epoch-Version-Release) of the package, without the disttag,
> >     e.g. 3.5.10-1 for 3.5.10-1.fc11, 3.5.10-1.1 for 3.5.10-1.fc11.1,
> >          6:4.2.2-1 if the package has Epoch 6 (the Epoch is specified
> > only if present and you use a ':' between Epoch and Version)
> >
> > * any other lines (elements separated by spaces):
> >   - dash (plain ASCII dash, please don't use some strange UTF-8
> > character) - text describing your change
> >   - if your change doesn't fit in one line, start a new line and indent
> > it with 2 spaces, so it is aligned with the text above (which has a dash
> > and a space)
> >   - bugs should be referenced as (#666666) (or, if there's any chance of
> >     confusion, (rh#666666)) for Fedora bugs and as (foo#666666), where
> > foo is the relevant bug tracker (e.g. kde, sf, fdo etc.), for upstream
> > bugs
>
> ( I have always been told that there should be one empty line between
> two entry :) )

Thanks Kevin and Pierre, that's a good description. If I could edit the wiki 
I'd add that to the guidelines.

The dash at the start of "other" lines is one thing that RPMlint doesn't 
check.

Björn Persson
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 190 bytes
Desc: This is a digitally signed message part.
Url : http://lists.fedoraproject.org/pipermail/devel/attachments/20090422/1b870845/attachment.bin 


More information about the devel mailing list