From 425b9fc977ff09b9fd8a10eaaa5406f6bc329c67 Mon Sep 17 00:00:00 2001
From: antrik <antrik@users.sf.net>
Date: Wed, 6 Jul 2011 11:03:02 +0200
Subject: dde/guide: Be clearer about requirement for creating new driver

Explain that it is only necessary to create a new driver if an
appropriate one isn't in DDE already; and mention which steps are
necessary only in this case.

Also be explicit about the fact that this guide only deals with
single-file drivers.
---
 hurd/dde/guide.mdwn | 37 ++++++++++++++++++++++++++++---------
 1 file changed, 28 insertions(+), 9 deletions(-)

diff --git a/hurd/dde/guide.mdwn b/hurd/dde/guide.mdwn
index 1418638c..c4ff1772 100644
--- a/hurd/dde/guide.mdwn
+++ b/hurd/dde/guide.mdwn
@@ -62,21 +62,36 @@ Get DDE code:
 
 > $ git clone git://git.sv.gnu.org/hurd/gnumach.git -b master-user_level_drivers gnumach_dde
 
-Now you need to get the actual driver from the Linux source tree.
-You have to find out which Linux driver
-is responsible for your network card,
-and which source file corresponds to this driver.
+Now comes the tricky part:
+you need to find out
+whether there is already a driver for your card
+in the DDE source tree,
+and otherwise get the driver code
+from the official Linux source tree.
+
+For this, you have to find out which Linux driver
+is responsible for your network card.
 In this guide we will use the forcedeth driver
 (for Nvidia nForce chipsets) as example.
+We check whether there is already a `dde_forcedeth` directory
+in the newly cloned `hurd_dde` tree.
+If there isn't, we have to find and download
+the right source file from Linux:
 
 Point a (JavaScript-capable) web browser at
 
 > http://git.kernel.org/?p=linux/kernel/git/stable/linux-2.6.29.y.git;a=tree;f=drivers/net;hb=HEAD
 
-Find the right file to download (e.g. forcedeth.c),
-hit the "raw" link,
+Find the right file to download
+(forcedeth.c in this example);
+then hit the "raw" link,
 and save the resulting file (page) to /mnt/home
 
+(If you happen to need one of the few drivers
+that consist of more than one source file,
+the process will be more complicated,
+and can't be covered in this guide...)
+
 
 Now everything should be in place,
 so we can boot into Hurd to do the actual work.
@@ -95,7 +110,9 @@ Build a DDE-enabled Mach (this and following parts can be done as normal user):
 
 > $ make
 
-Prepare the driver for your network card:
+
+If not already present in DDE,
+we need to prepare the driver for the network card:
 
 > $ cd ../hurd_dde
 
@@ -121,7 +138,7 @@ Prepare the driver for your network card:
 
 > $ cd ..
 
-Commit the driver with git.
+Commit the new driver with git.
 This will be helpful if we update the DDE code later;
 as well as for creating a patch for later reuse
 and/or upstream submission:
@@ -130,7 +147,9 @@ and/or upstream submission:
 
 > $ git commit -a -m 'Add forcedeth driver'
 
-Build the necessary Hurd and DDE bits:
+
+Having prepared the driver,
+we can now build the necessary Hurd and DDE bits:
 
 > $ autoreconf -i && ./configure
 
-- 
cgit v1.2.3