improve documentation
[Biblio-RFID.git] / README
diff --git a/README b/README
index ba6c49c..28ee13e 100644 (file)
--- a/README
+++ b/README
@@ -1,63 +1,90 @@
-RFID-Biblio
+NAME
+    RFID::Biblio - perl tools to use different RFID readers for library use
 
-The README is used to introduce the module and provide instructions on
-how to install the module, any machine dependencies it may have (for
-example C compilers and installed libraries) and any other information
-that should be provided before the module is installed.
+DESCRIPTION
+    Main idea is to develop simple API to reader, and than provide useful
+    abstractions on top of it to quickly write applications to respond on
+    tags which come in range of RFID reader using RFID::Biblio::Reader.
 
-A README file is required for CPAN modules since CPAN extracts the README
-file from a module distribution so that people browsing the archive
-can use it to get an idea of the module's uses. It is usually a good idea
-to provide version information here so that people can decide whether
-fixes for the module are worth downloading.
+    Writing support for new RFID readers should be easy.
+    RFID::Biblio::Reader::API provides documentation on writing support for
+    different readers.
 
+    Currently, two serial RFID readers based on RFID::Biblio::Reader::Serial
+    are implemented:
 
-INSTALLATION
+    *   RFID::Biblio::Reader::3M810
 
-To install this module, run the following commands:
+    *   RFID::Biblio::Reader::CPRM02
 
-       perl Makefile.PL
-       make
-       make test
-       make install
+    There is also simple read-only reader using shell commands in
+    RFID::Biblio::Reader::librfid.
 
-SUPPORT AND DOCUMENTATION
+    For implementing application take a look at RFID::Biblio::Reader
 
-After installing, you can find documentation for this module with the
-perldoc command.
+    `scripts/RFID-JSONP-server.pl' is example of such application. It's
+    local interface to RFID reader and JSONP REST server.
 
-    perldoc RFID::Biblio
+    `examples/koha-rfid.js' is jQuery based JavaScript code which can be
+    inserted in Koha Library System to provide overlay with tags in range
+    and check-in/check-out form-fill functionality.
 
-You can also look for information at:
+HARDWARE SUPPORT
+  3M 810
+    RFID::Biblio::Reader::3M810
 
-    RT, CPAN's request tracker
+  CPR-M02
+    RFID::Biblio::Reader::CPRM02
+
+  librfid
+    RFID::Biblio::Reader::librfid
+
+AUTHOR
+    Dobrica Pavlinusic, `<dpavlin at rot13.org>'
+
+BUGS
+    Please report any bugs or feature requests to `bug-rfid-biblio at
+    rt.cpan.org', or through the web interface at
+    http://rt.cpan.org/NoAuth/ReportBug.html?Queue=RFID-Biblio. I will be
+    notified, and then you'll automatically be notified of progress on your
+    bug as I make changes.
+
+SUPPORT
+    You can find documentation for this module with the perldoc command.
+
+        perldoc RFID::Biblio
+        perldoc RFID::Biblio::Reader
+        perldoc RFID::Biblio::Reader::API
+
+    You can also look for information at:
+
+    * RT: CPAN's request tracker
         http://rt.cpan.org/NoAuth/Bugs.html?Dist=RFID-Biblio
 
-    AnnoCPAN, Annotated CPAN documentation
+    * AnnoCPAN: Annotated CPAN documentation
         http://annocpan.org/dist/RFID-Biblio
 
-    CPAN Ratings
+    CPAN Ratings
         http://cpanratings.perl.org/d/RFID-Biblio
 
-    Search CPAN
+    Search CPAN
         http://search.cpan.org/dist/RFID-Biblio/
 
-
+ACKNOWLEDGEMENTS
 LICENSE AND COPYRIGHT
+    Copyright 2010 Dobrica Pavlinusic.
 
-Copyright (C) 2010 Dobrica Pavlinusic
-
-This program is free software; you can redistribute it and/or modify
-it under the terms of the GNU General Public License as published by
-the Free Software Foundation; version 2 dated June, 1991 or at your option
-any later version.
+    This program is free software; you can redistribute it and/or modify it
+    under the terms of the GNU General Public License as published by the
+    Free Software Foundation; version 2 dated June, 1991 or at your option
+    any later version.
 
-This program is distributed in the hope that it will be useful,
-but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-GNU General Public License for more details.
+    This program is distributed in the hope that it will be useful, but
+    WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
+    Public License for more details.
 
-A copy of the GNU General Public License is available in the source tree;
-if not, write to the Free Software Foundation, Inc.,
-59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+    A copy of the GNU General Public License is available in the source
+    tree; if not, write to the Free Software Foundation, Inc., 59 Temple
+    Place - Suite 330, Boston, MA 02111-1307, USA.