Gentoo Logo
Gentoo Spaceship




Note: Due to technical difficulties, the Archives are currently not up to date. GMANE provides an alternative service for most mailing lists.
c.f. bug 424647
List Archive: gentoo-announce
Navigation:
Lists: gentoo-announce: < Prev By Thread Next > < Prev By Date Next >
Headers:
To: gentoo-announce@g.o
From: Geert Bevin <gbevin@...>
Subject: NEW: seperate ChangeLog file for each portage package
Date: 05 Feb 2002 01:55:55 +0100
Hello everyone,

as you probably noticed, recently all portage package directories have a
new 'ChangeLog' file. This file is supposed to be actively maintained by
every ebuild author. If you notice that the file isn't up-to-date,
notify the author nicely ;-). The ChangeLog contains information about
what has been changed to the package for the user. This makes it easy to
determine if the changes are important enough to compile and merge a new
version of a package.

For ebuild authors:
------------------

Remember that this changelog is targetted to users. This means that the
comments should be well explained and written in clean English. 
  
Every new version or revision of the package has to be marked by a '*'
seperator line. Changements since the last revision have to be added to
the top of the file, underneath the initial copyright and cvs header
comments.
  
This means that you start with header line that has the following
format:

    date; your_name <your_email> changed_file1, changed_file2 :
	  
Below that line your explanation should follow. It has to be indented,
paragraphed and wrapped at a linewidth of 80 characters.
  
Any details about what exactly changed in the code should be added as a
message when the changes are committed to cvs, not to the ChangeLog
file.

If you have to create a ChangeLog file for a new package, you can take
the skel.ChangeLog file to start off with.

Best regards,

Geert Bevin

-- 
Geert Bevin
the Leaf sprl/bvba
"Use what you need"           Pierre Theunisstraat 1/47
http://www.theleaf.be         1030 Brussels
gbevin@...             Tel & Fax +32 2 241 19 98


Navigation:
Lists: gentoo-announce: < Prev By Thread Next > < Prev By Date Next >
Previous by thread:
portage 1.8.8-r1
Next by thread:
-r15.iso released
Previous by date:
portage 1.8.8-r1
Next by date:
-r15.iso released


Updated Jun 17, 2009

Summary: Archive of the gentoo-announce mailing list.

Donate to support our development efforts.

Copyright 2001-2013 Gentoo Foundation, Inc. Questions, Comments? Contact us.