Date: Wed, 27 Sep 2006 03:02:22 -0600 From: Scott Long <scottl@samsco.org> To: Daniel Gerzo <danger@FreeBSD.org> Cc: Tom Rhodes <trhodes@FreeBSD.org>, src-committers@FreeBSD.org, cvs-src@FreeBSD.org, cvs-all@FreeBSD.org, brueffer@FreeBSD.org, Ceri Davies <ceri@submonkey.net> Subject: Re: cvs commit: src/share/examples/mdoc example.4 Message-ID: <451A3E1E.2070403@samsco.org> In-Reply-To: <20060927104921.jd9ee4550kssgc04@mail.rulez.sk> 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>
next in thread | previous in thread | raw e-mail | index | archive | help
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... 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 =-) Scott
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?451A3E1E.2070403>