Date: Wed, 13 Feb 2002 20:50:00 +0000 From: Ceri <setantae@submonkey.net> To: FreeBSD-gnats-submit@freebsd.org Subject: docs/34914: More fixup for Developers' Handbook : Driver Basics chapter Message-ID: <E16b6Lo-000AnG-00@rhadamanth.private.submonkey.net>
next in thread | raw e-mail | index | archive | help
>Number: 34914
>Category: docs
>Synopsis: More fixup for Developers' Handbook : Driver Basics chapter
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: doc-bug
>Submitter-Id: current-users
>Arrival-Date: Wed Feb 13 13:00:01 PST 2002
>Closed-Date:
>Last-Modified:
>Originator: Ceri <setantae@submonkey.net>
>Release: FreeBSD 4.5-STABLE i386
>Organization:
>Environment:
System: FreeBSD rhadamanth.private.submonkey.net 4.5-STABLE FreeBSD 4.5-STABLE #0: Tue Feb 12 17:56:57 GMT 2002 setantae@rhadamanth.private.submonkey.net:/usr/obj/usr/src/sys/RHADAMANTH i386
>Description:
- Formalise markup.
- Fix some broken &prompt.root entities that somehow were making it past
"make lint"..
- Amend strange "administrator commands" phrase. Your call on this one.
- Some grammatical changes.
Ceri
>How-To-Repeat:
>Fix:
--- doc/en_US.ISO8859-1/books/developers-handbook/driverbasics/chapter.sgml.old Wed Feb 13 20:29:18 2002
+++ doc/en_US.ISO8859-1/books/developers-handbook/driverbasics/chapter.sgml Wed Feb 13 20:45:07 2002
@@ -49,7 +49,7 @@
changes.</para>
<para>The kld interface is used through the following
- administrator commands :
+ privileged commands :
<itemizedlist>
<listitem><simpara><command>kldload</command> - loads a new kernel
@@ -123,8 +123,7 @@
<para>Simply running <command>make</command> with this makefile
will create a file <filename>skeleton.ko</filename> that can
be loaded into your system by typing :
-<screen> &prompt.root
- kldload -v ./skeleton.ko</screen>
+<screen>&prompt.root; <userinput>kldload -v ./skeleton.ko</userinput></screen>
</para>
</sect2>
</sect1>
@@ -138,7 +137,7 @@
accesses a device node. The <command>/dev/MAKEDEV</command>
script makes most of the device nodes for your system but if you
are doing your own driver development it may be necessary to
- create your own device nodes with <command>mknod</command>
+ create your own device nodes with <command>mknod</command>.
</para>
<sect2>
@@ -146,7 +145,7 @@
<para>The <command>mknod</command> command requires four
arguments to create a device node. You must specify the name
- of this device node, the type of device, the major number of
+ of the device node, the type of device, the major number of
the device, and the minor number of the device.</para>
</sect2>
@@ -158,7 +157,7 @@
This eliminates the problems of potentially having a device
driver without a static device node, or a device node without
an installed device driver. Devfs is still a work in
- progress, but it is already working quite nice.</para>
+ progress, but it is already working quite nicely.</para>
</sect2>
</sect1>
@@ -337,13 +336,13 @@
<para>To install this driver you will first need to make a node on
your filesystem with a command such as : </para>
- <screen>&prompt.root mknod /dev/echo c 33 0</screen>
+ <screen>&prompt.root; <userinput>mknod /dev/echo c 33 0</userinput></screen>
<para>With this driver loaded you should now be able to type
something like :</para>
- <screen>&prompt.root echo -n "Test Data" > /dev/echo
-&prompt.root cat /dev/echo
+ <screen>&prompt.root; <userinput>echo -n "Test Data" > /dev/echo</userinput>
+&prompt.root; <userinput>cat /dev/echo</userinput>
Test Data</screen>
<para>Real hardware devices in the next chapter..</para>
>Release-Note:
>Audit-Trail:
>Unformatted:
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?E16b6Lo-000AnG-00>