[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: Patches to the installation manual 1: Appendix



(CCing as I'm not sure if you're subscribed.)

On Thursday 03 August 2006 02:53, Nathanael Nerode wrote:
> This fixes up some bad usage of English in the appendix.  I'm betting
> translators have done better than this on the whole....

You are completely correct...
Prompted by your mail and while applying your patch, I had a few ideas and 
I'd like to propose a slightly different patch which is based on your 
changes.

Please let us know what you think.

Index: files.xml
===================================================================
--- files.xml   (revision 39528)
+++ files.xml   (working copy)
@@ -5,14 +5,14 @@
  <sect1 id="linuxdevices"><title>Linux Devices</title>
 <para>

-In Linux you have various special files in
-<filename>/dev</filename>. These files are called device files. In
-the Unix world accessing hardware is different.  There you have a
-special file which actually runs a driver which in turn accesses the
-hardware. The device file is an interface to the actual system
-component. Files under <filename>/dev</filename> also behave
-differently than ordinary files. Below are the most important device
-files listed.
+In Linux various special files can be found under the directory
+<filename>/dev</filename>. These files are called device files and
+behave unlike ordinary files. The most common types of device files
+are for block devices and character devices. These files are an
+interface to the actual driver (part of the Linux kernel) which in
+turn accesses the hardware. Another, less common, type of device file
+is the <firstterm>named pipe</firstterm>.
+The most important device files are listed in the tables below.

 </para><para>

@@ -106,7 +106,7 @@
 <informaltable><tgroup cols="2"><tbody>
 <row>
   <entry><filename>null</filename></entry>
-  <entry>Everything pointed to this device will disappear</entry>
+  <entry>Anything written to this device will disappear</entry>
 </row><row>
   <entry><filename>zero</filename></entry>
   <entry>One can endlessly read zeros out of this device</entry>

Attachment: pgp9QxwF4Ue2z.pgp
Description: PGP signature


Reply to: