twiddling some documentation

diff --git a/INSTALL b/INSTALL
index 71ea3020b593301a33ad9081c20e7a6fc8e6fc69..67b49abca3c4077ad5ee3bedd263cb309b567462 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -11,17 +11,22 @@ but it should work and bugs will be fixed as they are reported.
 You can also prepare a kernel source tree that matches
 the kernel you are currently running if you have its config file (in
 the Debian distibution the config files for the kernel-image packages
-are installed into the /boot directory).  Perform the following steps:
+are installed into the /boot directory).  The following steps will
+(almost) set up your kernel sources correctly.  You will also need
+write permission to the kernel source directory the first time you
+run comedi's 'make config', so you might want to unpack the kernel 
+source into a directory you own.
+
 1) Get a copy of the kernel source that matches the kernel you are
        running.  Unpack it and copy your kernel config file to '.config'
        in the top directory of your kernel source.
-2) run 'make oldconfig' in your kernel source directory.
+2) Run 'make oldconfig' in your kernel source directory.
 3) You might need to edit the file 'Makefile' in the kernel source.
        At the top of the Makefile, the variable EXTRAVERSION is defined.
        If necessary, change it to match your kernel (for example, if the command
        'uname -r' produces "2.4.16-386" then your EXTRAVERSION should be
        set as 'EXTRAVERSION=-386'.
-4) run 'make dep' in the kernel source directory and you are done.
+4) Run 'make dep' in the kernel source directory and you are done.
 
 Red Hat users note: Kernel sources that are distributed with Red
 Hat Linux are not supported, because they are too heavily

diff --git a/include/linux/comedidev.h b/include/linux/comedidev.h
index fae7dc43a0e9bdfd474f2ad7e31e44efe22df689..28ded3981725e2507db099d28fc62d8bad4cde4b 100644 (file)
--- a/include/linux/comedidev.h
+++ b/include/linux/comedidev.h
@@ -133,13 +133,15 @@ struct comedi_async_struct{
        /* To avoid races and provide reliable overrun detection, read / writes
         * to buffer should proceed as follows:
         * Writing:
-        *   1) increment write count
-        *   2) write data to buffer
-        *   3) increment write ptr
+        *   1) if appropriate, check space in buffer, using either 'count' or 'ptr' members
+        *      ('count' members are more convenient).
+        *   2) increment write count
+        *   3) write data to buffer
+        *   4) increment write ptr
         * Reading:
         *   1) read data from buffer, using 'ptr' members to determine how much
-        *   2) update the read ptr, exactly when this occurs is not critical
-        *   3) check for overrun, using 'count' members
+        *   2) update the read ptr
+        *   3) if appropriate, check for overrun using 'count' members
         *   4) increment read count
         */
        volatile unsigned int buf_int_ptr;      /* buffer marker for interrupt */