m4/as-linux.m4: don't use backported pcmcia_loop_tuple()
[comedi.git] / README
diff --git a/README b/README
index 8dee7e439354fb2943ef4dc2dc619177b322f8ba..2dbd5eadc88f60e916de0fad8dd70fad5dc76259 100644 (file)
--- a/README
+++ b/README
@@ -1,30 +1,65 @@
 
-For installation instructions, look at the file INSTALL.  For notes
-of what is happening/changing in recent comedi releases, see the
-file NOTES.
+    COMEDI
+    The Linux Control and Measurement Device Interface
+    David Schleef <ds@schleef.org>
 
-This distribution contains just the Comedi kernel module.  You will
+
+* About Comedi:
+
+Comedi is a collection of drivers for data acquisition hardware.
+These drivers work with Linux, and also with Linux combined with
+the real-time extensions RTAI and RTLinux.  The Comedi core, which
+ties all the driver together, allows applications to be written
+that are completely hardware independent.
+
+Comedi supports a variety of data acquisition hardware; an
+incomplete list can be found in Documentation/comedi/drivers.txt.
+
+This distribution contains just the Comedi kernel modules.  You will
 almost certainly also want to download Comedilib, which is a user
 space library, a few utilities, and some example programs.
 
-Comedi has a mailing list.  Send "subscribe comedi" to
-comedi-request@stm.lbl.gov to subscribe.  Traffic is light, and mainly
-questions/answers about comedi installation, bugs, and programming.
-General questions about data acquisition are also welcome.
-Alternatively, you can subscribe and unsubscribe at
-http://stm.lbl.gov/cgi-bin/mailman/listinfo/comedi.
-You can always unsubscribe by sendinging "unsubscribe" (spell
-it correctly!) to comedi-request@stm.lbl.gov.
+* Installation:
+
+For installation instructions, look at the file INSTALL.
+
+* Mailing List:
+
+Questions about Comedi should be sent to the Comedi mailing list,
+<comedi_list@googlegroups.com>.  It is necessary to join the group
+before posting (see below).  It is also possible to post to the list
+using the web interface (see below).  Mailing the maintainer
+directly is always acceptable, but since the mailing list is
+archived and questions are often answered more quickly by others,
+the mailing list is preferred.
+
+To subscribe to and unsubscribe from the mailing list, or to read or
+post messages via the web interface, go to
+<http://groups.google.com/group/comedi_list>.  Alternatively, you
+can send a blank email to <comedi_list+subscribe@googlegroups.com>
+to subscribe, or to <comedi_list+unsubscribe@googlegroups.com> to
+unsubscribe (making sure the "From:" email address matches the
+address you originally subscribed with!).
+
+Traffic on the list is light, and mainly questions/answers about
+comedi installation, bugs, and programming.  General questions
+about data acquisition are also welcome.
+
+* More Information:
+
+Comedi also has a web page at <http://www.comedi.org/> from where
+updated versions may be downloaded.
 
-Comedi also has a web page, at http://stm.lbl.gov/comedi.  New versions
-of comedi can be found on the ftp site ftp://stm.lbl.gov/pub/comedi.
+Often bugfixes and new features that are not in the current release
+can be found in the Git repository.  Git snapshots can be created
+automatically at <http://comedi.org/git?p=comedi/comedi.git;a=tree>.
+The Git repository can be accessed anonymously using:
 
-Instructions for anonymous CVS access to the Comedi and Comedilib
-repositories are found at http://oss.lineo.com/cvs_anon.html.
+  git clone git://comedi.org/git/comedi.git
 
-Comedi may be freely distibuted and modified in accordance with the
+Comedi may be freely distributed and modified in accordance with the
 GNU General Public License.
 
 The person behind all this misspelled humor is David Schleef
-<ds@schleef.org>, or http://stm.lbl.gov/~ds.
+<ds@schleef.org>.