From owner-svn-src-head@FreeBSD.ORG  Mon Jul  8 02:08:27 2013
Return-Path: <owner-svn-src-head@FreeBSD.ORG>
Delivered-To: svn-src-head@FreeBSD.org
Received: by hub.freebsd.org (Postfix, from userid 1033)
 id F3432773; Mon,  8 Jul 2013 02:08:26 +0000 (UTC)
Date: Mon, 8 Jul 2013 02:08:26 +0000
From: Alexey Dokuchaev <danfe@FreeBSD.org>
To: Andriy Gapon <avg@FreeBSD.org>
Subject: Re: svn commit: r253002 - head
Message-ID: <20130708020826.GA31063@FreeBSD.org>
References: <201307072039.r67KdCdR028908@svn.freebsd.org>
 <9D4C7540-A3B0-45E5-8219-6A455D41DF70@gmail.com>
 <51D9DA55.2090808@freebsd.org> <51D9E069.5060300@FreeBSD.org>
 <51D9E2C0.6060603@freebsd.org> <51D9E57F.3090803@FreeBSD.org>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <51D9E57F.3090803@FreeBSD.org>
User-Agent: Mutt/1.5.21 (2010-09-15)
Cc: "svn-src-head@freebsd.org" <svn-src-head@FreeBSD.org>,
 "svn-src-all@freebsd.org" <svn-src-all@FreeBSD.org>,
 Alfred Perlstein <alfred@FreeBSD.org>,
 "src-committers@freebsd.org" <src-committers@FreeBSD.org>,
 Garrett Cooper <yaneurabeya@gmail.com>
X-BeenThere: svn-src-head@freebsd.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: SVN commit messages for the src tree for head/-current
 <svn-src-head.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/svn-src-head>,
 <mailto:svn-src-head-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/svn-src-head>
List-Post: <mailto:svn-src-head@freebsd.org>
List-Help: <mailto:svn-src-head-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/svn-src-head>,
 <mailto:svn-src-head-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Mon, 08 Jul 2013 02:08:27 -0000

On Mon, Jul 08, 2013 at 01:02:39AM +0300, Andriy Gapon wrote:
> I am sure that the next time you need to run the same thing you'll remember
> where you put the comment and you'll copy/paste from it.
> I am sure that if any other developer runs into the same situation, then he
> will:
> - google
> - ask on irc
> - ask on mailing lists
> - perhaps even read build(7)
> 
> I am sure that looking through the Makefile would be one of the last things
> on his mind.

It's quite on the contrary.  First people reach for comments/documentation;
only as a last resort they will use Google or ask on MLs.  Bad documentation
is probably one of the key of Google's success. :-)

./danfe

P.S.  You gotta be kidding us, right?