From owner-freebsd-ports@FreeBSD.ORG  Fri Oct 27 21:04:08 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 611BC16A415
	for <freebsd-ports@freebsd.org>; Fri, 27 Oct 2006 21:04:08 +0000 (UTC)
	(envelope-from infofarmer@gmail.com)
Received: from ug-out-1314.google.com (ug-out-1314.google.com [66.249.92.170])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 60D6B43D45
	for <freebsd-ports@freebsd.org>; Fri, 27 Oct 2006 21:04:07 +0000 (GMT)
	(envelope-from infofarmer@gmail.com)
Received: by ug-out-1314.google.com with SMTP id m2so701832uge
	for <freebsd-ports@freebsd.org>; Fri, 27 Oct 2006 14:04:06 -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=FN/4Y3NY3cnZMaW/vQG6BbBI+qNUEadTlOAuUXSKmW0L2zKTty8sCnHRYX0t3vaZAVHxrwK777hTy1Z6K7URglLQkkRHbT2tyncMGfUnL9k/4ejRDR4eoxXXJh1OULj0VbxENub+o7KZUgvmXu5urFxRd8ZaSH3HLr+cXgyWlxM=
Received: by 10.78.150.7 with SMTP id x7mr156363hud;
	Fri, 27 Oct 2006 14:04:06 -0700 (PDT)
Received: by 10.78.167.16 with HTTP; Fri, 27 Oct 2006 14:04:05 -0700 (PDT)
Message-ID: <cb5206420610271404hbb3ba6an99377535ebe1af98@mail.gmail.com>
Date: Sat, 28 Oct 2006 01:04:05 +0400
From: "Andrew Pantyukhin" <infofarmer@FreeBSD.org>
Sender: infofarmer@gmail.com
To: "Ion-Mihai IOnut Tetcu" <itetcu@freebsd.org>
In-Reply-To: <20061027231646.5b07bd8f@it.buh.tecnik93.com>
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>
	<cb5206420610270526p56bf0457i8e780b948a392d05@mail.gmail.com>
	<20061027231646.5b07bd8f@it.buh.tecnik93.com>
X-Google-Sender-Auth: 6a3e78fb0d7ce889
Cc: freebsd-ports@freebsd.org, Christopher Boumenot <boumenot@gmail.com>
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 21:04:08 -0000

On 10/28/06, Ion-Mihai IOnut Tetcu <itetcu@freebsd.org> wrote:
> On Fri, 27 Oct 2006 16:26:54 +0400
> "Andrew Pantyukhin" <infofarmer@FreeBSD.org> wrote:
>
> > 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.
>
> You all might want to take a look at what I do in
> mail/dspam[-devel]/[Makefile|files/UPDATING]

Yes, the idea is very bright. There's no rush however, so
let's look at how other people deal with it, among ports
committers and outside, before we set any standards in
stone.

[Wow, man, dspam ports is sure a place to learn many
things :-) Great job!]

Thanks!