public inbox for gentoo-dev@lists.gentoo.org
 help / color / mirror / Atom feed
From: Fabian Groffen <grobian@gentoo.org>
To: gentoo-dev@lists.gentoo.org
Subject: [gentoo-dev] [Council] ChangeLog generation within Gentoo
Date: Wed, 26 Oct 2011 19:02:12 +0200	[thread overview]
Message-ID: <20111026170212.GD843@gentoo.org> (raw)

[-- Attachment #1: Type: text/plain, Size: 2251 bytes --]

All,

As decided by the Council in its last meeting at the beginning of this
month, ChangeLogs will not be generated from VCS commit messages,
because the Council wants to keep the ability to edit generated
ChangeLog messages [1].

As a result, the Council took this up with the Portage team, to make
repoman update the ChangeLog file upon `repoman commit'.

Because some of the reasons put forward for autogenerating ChangeLogs
was the actual speed of making a commit, repoman does not call
echangelog, but instead uses its information about the current state of
the VCS directory it already collected to do its QA checks to write a
ChangeLog entry directly from Python (in which repoman is written).

To facilitate those developers who have echangelog, or their own scripts
that do the same, hardwired into their systems, repoman commit will by
default *NOT* update the ChangeLog if it is already modified.  This
allows to run echangelog followed by repoman commit, without getting a
double ChangeLog entry.

However, this also allows to do all kinds of other actions to the
ChangeLog file, without actually adding an entry for the current change
being committed, as we've already seen in practice.
The Council would like to remind developers that it is still a
requirement that all actions are documented in the ChangeLog and that it
is hence the responsibility of the committing developer to make sure
this requirement is met.

Repoman in the most recent Portage versions in the tree, has an
--echangelog flag, that takes the argument `y', `n' or `force'.  The
default for this option can be set to yes or no, and is controlled by
metadata/layout.conf.  For the `gentoo' (gentoo-x86) repository, this is
set to true, which results in the previously described behaviour.

When the ChangeLog is modified, but a new entry should still be written
by repoman, --echangelog=force will accomplish this.  Obviously, passing
--echangelog=n makes repoman skip writing a ChangeLog entry at all.


The Council hopes to have informed all developers sufficiently through
this message.


[1] http://www.gentoo.org/proj/en/council/meeting-logs/20111011-summary.txt

-- 
Fabian Groffen
Gentoo on a different level

[-- Attachment #2: Digital signature --]
[-- Type: application/pgp-signature, Size: 195 bytes --]

             reply	other threads:[~2011-10-26 17:03 UTC|newest]

Thread overview: 11+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2011-10-26 17:02 Fabian Groffen [this message]
2011-10-26 17:33 ` [gentoo-dev] [Council] ChangeLog generation within Gentoo Bruno
2011-10-26 17:56   ` Kent Fredric
2011-10-26 18:02     ` Rich Freeman
2011-10-26 21:00       ` Fabian Groffen
2011-10-27  3:28         ` [gentoo-dev] " Duncan
2011-10-27  7:05           ` Fabian Groffen
2011-10-26 18:07   ` [gentoo-dev] " Pacho Ramos
2011-10-26 19:24     ` Bruno
2011-10-26 23:56   ` [gentoo-dev] " Ryan Hill
2011-10-27  7:34   ` [gentoo-dev] " Michael Haubenwallner

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20111026170212.GD843@gentoo.org \
    --to=grobian@gentoo.org \
    --cc=gentoo-dev@lists.gentoo.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox