From owner-cvs-src@FreeBSD.ORG Wed Sep 27 15:29:17 2006 Return-Path: X-Original-To: cvs-src@freebsd.org Delivered-To: cvs-src@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 6527516A53C; Wed, 27 Sep 2006 15:29:17 +0000 (UTC) (envelope-from jhb@freebsd.org) Received: from server.baldwin.cx (66-23-211-162.clients.speedfactory.net [66.23.211.162]) by mx1.FreeBSD.org (Postfix) with ESMTP id 0C6F543E34; Wed, 27 Sep 2006 15:27:41 +0000 (GMT) (envelope-from jhb@freebsd.org) Received: from localhost.corp.yahoo.com (john@localhost [127.0.0.1]) (authenticated bits=0) by server.baldwin.cx (8.13.6/8.13.6) with ESMTP id k8RFROZO058728; Wed, 27 Sep 2006 11:27:35 -0400 (EDT) (envelope-from jhb@freebsd.org) From: John Baldwin To: danger@rulez.sk Date: Wed, 27 Sep 2006 11:27:09 -0400 User-Agent: KMail/1.9.1 References: <200609261959.k8QJxqkh068350@repoman.freebsd.org> <20060926202339.GA2039@haakonia.hitnet.RWTH-Aachen.DE> <20060927102234.dsupin91usswg4s0@mail.rulez.sk> In-Reply-To: <20060927102234.dsupin91usswg4s0@mail.rulez.sk> MIME-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit Content-Disposition: inline Message-Id: <200609271127.10798.jhb@freebsd.org> X-Greylist: Sender succeeded SMTP AUTH authentication, not delayed by milter-greylist-2.0.2 (server.baldwin.cx [127.0.0.1]); Wed, 27 Sep 2006 11:27:35 -0400 (EDT) X-Virus-Scanned: ClamAV 0.88.3/1947/Tue Sep 26 20:46:56 2006 on server.baldwin.cx X-Virus-Status: Clean X-Spam-Status: No, score=-4.4 required=4.2 tests=ALL_TRUSTED,AWL,BAYES_00 autolearn=ham version=3.1.3 X-Spam-Checker-Version: SpamAssassin 3.1.3 (2006-06-01) on server.baldwin.cx Cc: cvs-src@freebsd.org, Daniel Gerzo , src-committers@freebsd.org, cvs-all@freebsd.org, Christian Brueffer Subject: Re: cvs commit: src/share/examples/mdoc example.4 X-BeenThere: cvs-src@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: CVS commit messages for the src tree List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 27 Sep 2006 15:29:17 -0000 On Wednesday 27 September 2006 04:22, danger@rulez.sk wrote: > Quoting Christian Brueffer : > > > On Tue, Sep 26, 2006 at 07:59:52PM +0000, Daniel Gerzo wrote: > >> danger 2006-09-26 19:59:52 UTC > >> > >> FreeBSD src repository (doc committer) > >> > >> Modified files: > >> share/examples/mdoc example.4 > >> Log: > >> Remove second person from the sentece and rephrase a bit. > >> > >> Approved by: trhodes (mentor), keramida (mentor) > >> > >> Revision Changes Path > >> 1.26 +6 -8 src/share/examples/mdoc/example.4 > > > > I don't agree to these changes, see below for details (also I don't see where > > exactly you removed second person usage, it's still being used in the new > > version). > > We want to aviod to use words like "you", "your" and so on. I have > talked about it with Ruslan and my mentors. > > >> | -To compile the > >> | -.Ns Nm > >> | -driver into the kernel, > >> | -place the following lines in the > >> | -kernel configuration file: > >> | +To enable support for > >> | +.Ns Nm , > >> | +place the following lines in the kernel configuration file: > > > > The formulation used before was much more accurate WRT the distinction > > we make between compiling something into the kernel and loading it as a > > module. If we load something as a module we also "enable support for > > it". > > I think it's certainly clear to users that they can either enable > support for something in kernel _or_ load it as a module which would > bring that support without need of kernel recompilation. Not in the text you just wrote. The diff quoted above would now imply to at least some users that you have to compile drivers into the kernel since that's how one "enable[s] support for foo(4)". -- John Baldwin