Skip site navigation (1)Skip section navigation (2)
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>