From owner-freebsd-ports@FreeBSD.ORG  Fri Oct 27 12:26:57 2006
Return-Path: <owner-freebsd-ports@FreeBSD.ORG>
X-Original-To: freebsd-ports@freebsd.org
Delivered-To: freebsd-ports@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 4651D16A492
	for <freebsd-ports@freebsd.org>; Fri, 27 Oct 2006 12:26:57 +0000 (UTC)
	(envelope-from infofarmer@gmail.com)
Received: from ug-out-1314.google.com (ug-out-1314.google.com [66.249.92.171])
	by mx1.FreeBSD.org (Postfix) with ESMTP id E5E5643D45
	for <freebsd-ports@freebsd.org>; Fri, 27 Oct 2006 12:26:55 +0000 (GMT)
	(envelope-from infofarmer@gmail.com)
Received: by ug-out-1314.google.com with SMTP id m2so576229uge
	for <freebsd-ports@freebsd.org>; Fri, 27 Oct 2006 05:26:55 -0700 (PDT)
DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws; s=beta; d=gmail.com;
	h=received:message-id:date:from:sender:to:subject:cc:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references:x-google-sender-auth;
	b=GGrPEHES3cuiahSbBgzD8yvWPW53YP/Asq3l9QpPwT1t1EQdwmOyRkfAY5YtnIY8o4hIZ3/9bSXsi9PyAudfOJ6PK/Nn4WNQLEijgUykNTz1LXPKWWLe9bhOXfri3sCSHpAEjyYUIwOuZV537k+L4ccORfK708tgGT/7zPZhU+g=
Received: by 10.78.203.13 with SMTP id a13mr3743044hug;
	Fri, 27 Oct 2006 05:26:54 -0700 (PDT)
Received: by 10.78.167.16 with HTTP; Fri, 27 Oct 2006 05:26:54 -0700 (PDT)
Message-ID: <cb5206420610270526p56bf0457i8e780b948a392d05@mail.gmail.com>
Date: Fri, 27 Oct 2006 16:26:54 +0400
From: "Andrew Pantyukhin" <infofarmer@FreeBSD.org>
Sender: infofarmer@gmail.com
To: "Christopher Boumenot" <boumenot@gmail.com>
In-Reply-To: <ehs1qk$6pa$1@sea.gmane.org>
MIME-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
Content-Disposition: inline
References: <ehs1qk$6pa$1@sea.gmane.org>
X-Google-Sender-Auth: 9209ed88840638db
Cc: freebsd-ports@freebsd.org
Subject: Re: port_history - track port commit message comments
X-BeenThere: freebsd-ports@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Porting software to FreeBSD <freebsd-ports.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-ports>,
	<mailto:freebsd-ports-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-ports>
List-Post: <mailto:freebsd-ports@freebsd.org>
List-Help: <mailto:freebsd-ports-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-ports>,
	<mailto:freebsd-ports-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Fri, 27 Oct 2006 12:26:57 -0000

On 10/27/06, Christopher Boumenot <boumenot@gmail.com> wrote:
> Every time I upgrade a port I am usually left wondering what changed.

Some other projects maintain special package-specific
ChangeLog files. Maybe VCS logs is not the best place
for documentation, because it's not as easily accessible
as a flat file would be.

Moreover, I think porters don't document the hacks they
have to employ - just because there's nowhere to do that.