Date: Wed, 27 Sep 2006 04:13:09 -0600 From: Scott Long <scottl@samsco.org> To: Tom Rhodes <trhodes@FreeBSD.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: <451A4EB5.4090208@samsco.org> In-Reply-To: <20060927055313.28313885.trhodes@FreeBSD.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> <20060927055313.28313885.trhodes@FreeBSD.org>
next in thread | previous in thread | raw e-mail | index | archive | help
Tom Rhodes wrote:
> 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. :)
>
Considering that this is meant for section 4 of the manual, and
intro.4 says the following:
INTRO(4) FreeBSD Kernel Interfaces Manual INTRO(4)
NAME
intro -- introduction to devices and device drivers
The terms 'driver' and 'module' are very much appropriate when talking
about 'device drivers'.
Scott
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?451A4EB5.4090208>