Date: Wed, 27 Sep 2006 05:53:13 -0400 From: Tom Rhodes <trhodes@FreeBSD.org> To: Scott Long <scottl@samsco.org> Cc: src-committers@FreeBSD.org, cvs-src@FreeBSD.org, cvs-all@FreeBSD.org, danger@FreeBSD.org, brueffer@FreeBSD.org, ceri@submonkey.net Subject: Re: cvs commit: src/share/examples/mdoc example.4 Message-ID: <20060927055313.28313885.trhodes@FreeBSD.org> In-Reply-To: <451A3E1E.2070403@samsco.org> References: <200609261959.k8QJxqkh068350@repoman.freebsd.org> <20060926202339.GA2039@haakonia.hitnet.RWTH-Aachen.DE> <20060927034124.2c57b517.trhodes@FreeBSD.org> <20060927075314.GQ54669@submonkey.net> <20060927041526.6b33a348.trhodes@FreeBSD.org> <20060927084514.GR54669@submonkey.net> <20060927104921.jd9ee4550kssgc04@mail.rulez.sk> <451A3E1E.2070403@samsco.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Wed, 27 Sep 2006 03:02:22 -0600 Scott Long <scottl@samsco.org> wrote: > Daniel Gerzo wrote: > > > Quoting Ceri Davies <ceri@submonkey.net>: > > > >> > >> No, we're arguing over grammar. The sentence currently renders as > >> something like: > >> > >> Alternatively, to load the fxp(4) as a module at boot time... > >> > > > > I proposed the following change: > > > > Alternatively, to load > > .Ns Nm > > module at boot time... > > > >> That's wrong. Getting rid of "the" works. > >> > > > > It should read: > > Alternatively, to load the fxp(4) driver as a module at boot time... > > not > > Alternatively, to load fxp(4) module at boot time... > > nor > > Alternatively, to load the fxp(4) as a module at boot time... > > nor > > Alternatively, to load the fxp(4) as a module at boot time... > > The following is correct, but is inconsistent with the preceding > context. There has been no introduction in text of the term > 'module', so trying to interchange it with the term 'driver', which > has been introduced, is clumsy. Furthermore, the terms 'driver' and > 'module' are not synonymous in the context, and thus are not > interchangable. > > Alternatively, to load the fxp(4) module at boot time... I'd like to see "driver" and "module" removed from this particular example page. :) > > That said, attention to detail in the docs is _always_ appreciated, > and good, open discussions are always welcomed. It's just a bit > surrealistic to watch a grammar discussion happen between a group of > non-native speakers at 3am =-) Yea, why ARE you up right now? :P -- Tom Rhodes
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20060927055313.28313885.trhodes>