From owner-svn-src-head@FreeBSD.ORG Sat Aug 21 12:07:44 2010 Return-Path: Delivered-To: svn-src-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id D074A1065695; Sat, 21 Aug 2010 12:07:44 +0000 (UTC) (envelope-from rpaulo@freebsd.org) Received: from karen.lavabit.com (karen.lavabit.com [72.249.41.33]) by mx1.freebsd.org (Postfix) with ESMTP id 535E38FC0C; Sat, 21 Aug 2010 12:07:44 +0000 (UTC) Received: from d.earth.lavabit.com (d.earth.lavabit.com [192.168.111.13]) by karen.lavabit.com (Postfix) with ESMTP id CBCD311B988; Sat, 21 Aug 2010 07:07:43 -0500 (CDT) Received: from 10.0.10.3 (54.81.54.77.rev.vodafone.pt [77.54.81.54]) by lavabit.com with ESMTP id 0W3PGIZP2RIU; Sat, 21 Aug 2010 07:07:43 -0500 Mime-Version: 1.0 (Apple Message framework v1081) Content-Type: text/plain; charset=us-ascii From: Rui Paulo In-Reply-To: <4C6DDB74.3090102@FreeBSD.org> Date: Sat, 21 Aug 2010 13:07:39 +0100 Content-Transfer-Encoding: quoted-printable Message-Id: <7186318F-0921-41E5-9641-3D6B45E0623B@FreeBSD.org> References: <201008191131.o7JBV4Yf002412@svn.freebsd.org> <4C6D18BE.2000905@fer.hr> <4C6D95A8.9070105@FreeBSD.org> <20100819213159.B48418@maildrop.int.zabbadoz.net> <4C6DDB74.3090102@FreeBSD.org> To: Doug Barton X-Mailer: Apple Mail (2.1081) Cc: svn-src-head@FreeBSD.org, Ana Kukec , svn-src-all@FreeBSD.org, "Bjoern A. Zeeb" , src-committers@FreeBSD.org Subject: Re: svn commit: r211501 - in head/sys: modules modules/send netinet netinet6 sys X-BeenThere: svn-src-head@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: SVN commit messages for the src tree for head/-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 21 Aug 2010 12:07:44 -0000 On 20 Aug 2010, at 02:33, Doug Barton wrote: > On 08/19/2010 14:50, Bjoern A. Zeeb wrote: >> On Thu, 19 Aug 2010, Doug Barton wrote: >>=20 >>> On 08/19/2010 04:42, Ana Kukec wrote: >>>> Hi all, >>>>=20 >>>> A man page for the kernel side SeND, and an updated port with >>>> Secure Neighbor Discovery application will follow soon. >>>=20 >>> At minimum committing the man page along with new code is how such >>> things should be done. Can you define "soon?" >>=20 >> Yes I can: soon will be when it'll be comitted. >=20 > I'm guessing that's an attempt at humor, but what I'm looking for is = an actual timeline. If the answer is "in the next day or two" then = that's fine, we'll let this one go with a warning. If the answer is = "someday" then I'm going to request that the code be backed out until = the man page(s) are done. I'm actually trying to be reasonable and work = with a new developer so that they can learn how we like to have things = done around here. What are you trying to do? What? Are you serious? Do you really want some code to be backed out = because it doesn't have a man page yet? Talking about overkill.. You don't seem to have an idea how many times code was committed without = a man page. I didn't see you complain back then.. It's very likely you wouldn't be = complaining if the developer in question hadn't posted a message to the = mailing list saying she intends to commit a man page soon. >=20 >> Meanwhile if you have time I'd know several dozen other things we >> don't have a man page for ... >=20 > I would definitely recommend that you make a list of them, preferably = someplace visible like the wiki. If you don't already have access to the = wiki (or some other suitable forum) then send the list to -doc@ and = we'll make sure that it gets posted. Given the recent resurgence of = interest in updating our documentation it certainly wouldn't hurt to = have some examples of low-hanging fruit that we can turn budding mdoc = gurus loose on. >=20 > Meanwhile, the fact that in the past code has been committed without = man pages is the exact cause of the problem you're describing. It is = certainly not a justification for continuing to do it wrong. Reverting code just because it doesn't have a man page is pointless. = Everyone can write the damn man page, but not everyone can write code. = You should really take this into consideration when proposing a commit = to be reverted. Regards, -- Rui Paulo