From owner-svn-doc-all@FreeBSD.ORG Tue Feb 12 02:14:16 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id EE0FADE9; Tue, 12 Feb 2013 02:14:16 +0000 (UTC) (envelope-from kaduk@mit.edu) Received: from dmz-mailsec-scanner-3.mit.edu (DMZ-MAILSEC-SCANNER-3.MIT.EDU [18.9.25.14]) by mx1.freebsd.org (Postfix) with ESMTP id 611B2CC8; Tue, 12 Feb 2013 02:14:16 +0000 (UTC) X-AuditID: 1209190e-b7f266d0000008cb-bb-5119a445fb45 Received: from mailhub-auth-4.mit.edu ( [18.7.62.39]) by dmz-mailsec-scanner-3.mit.edu (Symantec Messaging Gateway) with SMTP id A3.6E.02251.544A9115; Mon, 11 Feb 2013 21:09:09 -0500 (EST) Received: from outgoing.mit.edu (OUTGOING-AUTH-1.MIT.EDU [18.9.28.11]) by mailhub-auth-4.mit.edu (8.13.8/8.9.2) with ESMTP id r1C299qI028964; Mon, 11 Feb 2013 21:09:09 -0500 Received: from multics.mit.edu (SYSTEM-LOW-SIPB.MIT.EDU [18.187.2.37]) (authenticated bits=56) (User authenticated as kaduk@ATHENA.MIT.EDU) by outgoing.mit.edu (8.13.8/8.12.4) with ESMTP id r1C296gB012046 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Mon, 11 Feb 2013 21:09:08 -0500 Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id r1C2959G018284; Mon, 11 Feb 2013 21:09:05 -0500 (EST) Date: Mon, 11 Feb 2013 21:09:05 -0500 (EST) From: Benjamin Kaduk To: Eitan Adler Subject: Re: svn commit: r40942 - head/en_US.ISO8859-1/books/arch-handbook/driverbasics In-Reply-To: <201302111346.r1BDkQXD012859@svn.freebsd.org> Message-ID: References: <201302111346.r1BDkQXD012859@svn.freebsd.org> User-Agent: Alpine 1.10 (GSO 962 2008-03-14) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFvrAIsWRmVeSWpSXmKPExsUixG6nruu6RDLQoOeQvsWPj4eYLHb9ncNs cWPRfiaL3f29zA4sHjM+zWcJYIzisklJzcksSy3St0vgynhw37ngP0/F9puzWRoY13B1MXJy SAiYSCx9v4IFwhaTuHBvPVsXIxeHkMA+Rokzs2YzQTgbGSU2ddxhh3AOMUm0T/rACNIiJNDA KHHjXBmIzSKgLfGzvRNsFJuAisTMNxvZQGwRIPv7/p9MIDazQJTEnqWNrCC2sECkxL8Fm4GG cnBwClhJNB7UAAnzCjhILNnaxA4x3lJi1rz1YK2iAjoSq/dPYYGoEZQ4OfMJC8RIS4l/a3+x TmAUnIUkNQtJagEj0ypG2ZTcKt3cxMyc4tRk3eLkxLy81CJdY73czBK91JTSTYyggOWU5NvB +PWg0iFGAQ5GJR7eBlHJQCHWxLLiytxDjJIcTEqivP/mA4X4kvJTKjMSizPii0pzUosPMUpw MCuJ8C77KBEoxJuSWFmVWpQPk5LmYFES572SctNfSCA9sSQ1OzW1ILUIJivDwaEkweu1GGio YFFqempFWmZOCUKaiYMTZDgP0PBkkBre4oLE3OLMdIj8KUZFKXHeFJCEAEgiozQPrheWUF4x igO9IsxbAlLFA0xGcN2vgAYzAQ3mzBEHGVySiJCSamAM3VheM7PX0W/XIoUtKr1bG5TVK7Xn abaofn59P37KXz1Nv+Mz7lU/VZzWqdV565PX+4PRysqL4t8lOH3Suf71ROK3H8nfrvl3L1ur G2q5+XSgaNRvvsPzG7++3yDWmrp3Kue03shJwTnuE84Vrji1aukf3usmDvtKt+wMFbMRb/4j 7V6/tHK9EktxRqKhFnNRcSIAjaUisgMDAAA= Cc: svn-doc-head@freebsd.org, svn-doc-all@freebsd.org, doc-committers@freebsd.org X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 12 Feb 2013 02:14:17 -0000 On Mon, 11 Feb 2013, Eitan Adler wrote: > > Modified: head/en_US.ISO8859-1/books/arch-handbook/driverbasics/chapter.xml > ============================================================================== > --- head/en_US.ISO8859-1/books/arch-handbook/driverbasics/chapter.xml Mon Feb 11 13:46:24 2013 (r40941) > +++ head/en_US.ISO8859-1/books/arch-handbook/driverbasics/chapter.xml Mon Feb 11 13:46:26 2013 (r40942) > @@ -135,17 +134,17 @@ DECLARE_MODULE(skeleton, skel_mod, SI_SU > > Makefile > > - FreeBSD provides a makefile include that you can use to > - quickly compile your kernel addition. > + FreeBSD provides a makefile include to > + quickly compile a kernel addition. This sentence does not seem right -- the user compiles the module, not the include file. I think these .mk files are referred to as "system makefiles", anyway. The best I can do on short notice is: "FreeBSD provides a system makefile to simplify compiling a kernel module." > SRCS=skeleton.c > KMOD=skeleton > > @@ -201,8 +200,8 @@ KMOD=skeleton > the source tree. > > This simple example pseudo-device remembers whatever values > - you write to it and can then supply them back to you when you > - read from it. > + that are written to it and can then echo them back when > + read. "whatever values that are written to it" doesn't seem right; "whatever values are written to it" feels much better. -Ben > > Example of a Sample Echo Pseudo-Device Driver for