Date: Fri, 14 Jan 2005 12:29:37 +0200 From: Giorgos Keramidas <keramida@ceid.upatras.gr> To: Marc Fonvieille <blackend@FreeBSD.org> Cc: doc-committers@FreeBSD.org Subject: Re: cvs commit: doc/en_US.ISO8859-1/books/handbook/config chapter.sgml Message-ID: <20050114102937.GA31098@orion.daedalusnetworks.priv> In-Reply-To: <20050114102331.GB617@nosferatu.blackend.org> References: <200501140831.j0E8VU47050373@repoman.freebsd.org> <20050114091403.GA617@nosferatu.blackend.org> <41E78F18.6090006@FreeBSD.org> <20050114095448.GD30089@orion.daedalusnetworks.priv> <20050114102331.GB617@nosferatu.blackend.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On 2005-01-14 11:23, Marc Fonvieille <blackend@FreeBSD.org> wrote:
>On Fri, Jan 14, 2005 at 11:54:48AM +0200, Giorgos Keramidas wrote:
>>On 2005-01-14 12:21, Denis Peplin <den@FreeBSD.org> wrote:
>>>Marc Fonvieille wrote:
>>>>On Fri, Jan 14, 2005 at 08:31:30AM +0000, Denis Peplin wrote:
>>>>> Modified files:
>>>>> en_US.ISO8859-1/books/handbook/config chapter.sgml
>>>>> Log:
>>>>> Do not say that ed loadable module is not available - it is available for
>>>>> both 4.X and 5.X
>>>>
>>>> The "(ISA cards, for example)" sounds really weird, it does not match
>>>> with the rest of the sentence since it talks about drivers.
>>>
>>> Is this better?
>>> - network card drivers (ISA cards, for example).
>>> + network cards (ISA cards, for example).
>>
>> Hi Dennis and everyone :)
>>
>> How about?
>>
>> Not all NIC drivers are available as modules; notable examples
>> are ISA NICs.
>>
>
> Is it still correct? I mean in the "current" FreeBSD versions?
>
> I'd write something like:
>
> The easiest way is to simply load a kernel module for your network card
> with kldload(8) (a module may not be available for all network card drivers,
> it was the case in past for some ISA cards).
I'm not sure. Someone with a bit of experience with the module system
may be of help here. If ISA NIC drivers are still unavailable as
modules, here's how I would write the relevant bit:
%%%
Index: chapter.sgml
===================================================================
RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/config/chapter.sgml,v
retrieving revision 1.197
diff -u -r1.197 chapter.sgml
--- chapter.sgml 14 Jan 2005 08:31:30 -0000 1.197
+++ chapter.sgml 14 Jan 2005 10:27:29 -0000
@@ -908,19 +908,30 @@
driver are present on the system.</para>
<para>To use your network card, you will need to load the proper
- driver. This may be accomplished in one of two ways. The
- easiest way is to simply load a kernel module for your network
- card with &man.kldload.8;. A module is not available for all
- network card drivers (ISA cards, for example).
- Alternatively, you may statically compile
- the support for your card into your kernel. Check
- <filename>/usr/src/sys/conf/NOTES</filename>,
- <filename>/usr/src/sys/<replaceable>arch</replaceable>/conf/NOTES</filename> and the
- manual page of the driver to know what to add in your kernel
- configuration file. For more information about recompiling your
- kernel, please see <xref linkend="kernelconfig">. If your card
- was detected at boot by your kernel (<filename>GENERIC</filename>)
- you do not have to build a new kernel.</para>
+ driver. This may be accomplished in one of two ways:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>The easiest way is to simply load a kernel module for
+ your network card with &man.kldload.8;. Not all NIC
+ drivers are available as modules; notable examples of
+ devices for which modules do not exist are ISA cards.</para>
+ </listitem>
+
+ <listitem>
+ <para>Alternatively, you may statically compile the support
+ for your card into your kernel. Check
+ <filename>/usr/src/sys/conf/NOTES</filename>,
+ <filename>/usr/src/sys/<replaceable>arch</replaceable>/conf/NOTES</filename>
+ and the manual page of the driver to know what to add in
+ your kernel configuration file. For more information
+ about recompiling your kernel, please see <xref
+ linkend="kernelconfig">. If your card was detected at
+ boot by your kernel (<filename>GENERIC</filename>) you do
+ not have to build a new kernel.</para>
+ </para>
+ </listitem>
+ </itemizedlist>
</sect2>
<sect2>
%%%
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20050114102937.GA31098>