From owner-freebsd-ports@FreeBSD.ORG Mon Oct 30 20:29:58 2006 Return-Path: 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 E968C16A492 for ; Mon, 30 Oct 2006 20:29:58 +0000 (UTC) (envelope-from infofarmer@gmail.com) Received: from ug-out-1314.google.com (ug-out-1314.google.com [66.249.92.173]) by mx1.FreeBSD.org (Postfix) with ESMTP id 4704F43DB6 for ; Mon, 30 Oct 2006 20:29:18 +0000 (GMT) (envelope-from infofarmer@gmail.com) Received: by ug-out-1314.google.com with SMTP id m2so1064401uge for ; Mon, 30 Oct 2006 12:29:17 -0800 (PST) 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=Q4VkWxjzgQZ3W3O2u9V34HisUo2LJmo8KJ2dEwOlm3ByAnwhDpyhMytg2Giwob/KlPXHNmtceV2p7pRC4VfyjXyTHwhJQ5pWK3S7QPJSVJreCAT67InQJBxVUmpcbZb6+Udt/QgAE3dgFA8LCuKufanl2B2gtcwws37SsZJ8Rts= Received: by 10.78.200.20 with SMTP id x20mr5530392huf; Mon, 30 Oct 2006 12:29:17 -0800 (PST) Received: by 10.78.167.16 with HTTP; Mon, 30 Oct 2006 12:29:17 -0800 (PST) Message-ID: Date: Mon, 30 Oct 2006 23:29:17 +0300 From: "Andrew Pantyukhin" Sender: infofarmer@gmail.com To: "Doug Barton" In-Reply-To: <45464ADF.7040201@FreeBSD.org> MIME-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Content-Disposition: inline References: <20061027231646.5b07bd8f@it.buh.tecnik93.com> <20061028002501.32f5b845@it.buh.tecnik93.com> <45464ADF.7040201@FreeBSD.org> X-Google-Sender-Auth: 429a6da1e30b423f Cc: Ion-Mihai IOnut Tetcu , freebsd-ports@freebsd.org, Christopher Boumenot 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 30 Oct 2006 20:29:59 -0000 On 10/30/06, Doug Barton wrote: > Ion-Mihai IOnut Tetcu wrote: > > > The problem with the OP's work is that some submitters/commiters think > > that the CVS commit message should document the _port_ changes while > > others think it should also document (or at least provide pointers) to > > the changes in the software itself > > Good commit messages should do both. > > On the other hand, there is no substitute for the user/admin thinking > for themselves. I think that if we try to overengineer making things > foolproof, the universe will simply conspire to create "better" fools. This is not only for communication between porter and user, but also between porters. I'm sure good porter should be perfectly content in total isolation, but some porters love each other so much, they can only be happy when they're in touch. Documenting your thoughts when you're hacking a port trying to get it right is extremely important. This is the first, vital step on the road to effective collaboration. Wiki, articles, manpages, mailing lists, IRC and other methods of communications help immensely, but unfortunately they all get but a fraction of your thoughts for a bunch of reasons.