X-Git-Url: http://git.rot13.org/?p=Biblio-RFID.git;a=blobdiff_plain;f=README;h=9610b1c7b8d281e87342a5c6d36179eb73115559;hp=3e9e5edb5c1e0cc74159074da752b59ff23441a8;hb=07407d8a1d12e6cf9d50ec84d018d9b4c6a6538d;hpb=75a8809d9f67c952c0db9c3941ec615cace3c716

diff --git a/README b/README
index 3e9e5ed..9610b1c 100644
--- a/README
+++ b/README
@@ -1,73 +1,95 @@
-RFID-Biblio
+NAME
+    Biblio::RFID - perl tools to use different RFID readers for library use
 
-This is set of tools to use different RFID readers for library use.
+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 Biblio::RFID::Reader.
 
-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.
+    Writing support for new RFID readers should be easy.
+    Biblio::RFID::Reader::API provides documentation on writing support for
+    different readers.
 
-scripts/RFID-JSONP-server.pl is example of such application. It's local
-interface to RFID reader and JSONP REST server.
+    Currently, two serial RFID readers based on Biblio::RFID::Reader::Serial
+    are implemented:
 
-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.
+    *   Biblio::RFID::Reader::3M810
 
-Currently supported readers:
+    *   Biblio::RFID::Reader::CPRM02
 
- * 3M 810  - RFID::Biblio::Reader::3M810
- * CPR-M02 - RFID::Biblio::Reader::CPRM02
- * OpenPCD, The Omnikey CardMan 5121 and 5321 - RFID::Biblio::Reader::librfid
+    There is also simple read-only reader using shell commands in
+    Biblio::RFID::Reader::librfid.
 
-For status of each implementation see pod documentation inside them.
+    For implementing application take a look at Biblio::RFID::Reader
 
+    `scripts/RFID-JSONP-server.pl' is example of such application. It's
+    local interface to RFID reader and JSONP REST server.
 
-INSTALLATION
+    `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.
 
-To install this module, run the following commands:
+    Applications can use Biblio::RFID::RFID501 which is some kind of
+    semi-standard 3M layout or blocks on RFID tags.
 
-	perl Makefile.PL
-	make
-	make test
-	make install
+HARDWARE SUPPORT
+  3M 810
+    Biblio::RFID::Reader::3M810
 
-SUPPORT AND DOCUMENTATION
+  CPR-M02
+    Biblio::RFID::Reader::CPRM02
 
-After installing, you can find documentation for this module with the
-perldoc command.
+  librfid
+    Biblio::RFID::Reader::librfid
 
-    perldoc RFID::Biblio
+AUTHOR
+    Dobrica Pavlinusic, `<dpavlin at rot13.org>'
 
-You can also look for information at:
+    http://blog.rot13.org/
 
-    RT, CPAN's request tracker
-        http://rt.cpan.org/NoAuth/Bugs.html?Dist=RFID-Biblio
+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=Biblio-RFID. I will be
+    notified, and then you'll automatically be notified of progress on your
+    bug as I make changes.
 
-    AnnoCPAN, Annotated CPAN documentation
-        http://annocpan.org/dist/RFID-Biblio
+SUPPORT
+    You can find documentation for this module with the perldoc command.
 
-    CPAN Ratings
-        http://cpanratings.perl.org/d/RFID-Biblio
+        perldoc Biblio::RFID
+        perldoc Biblio::RFID::Reader
+        perldoc Biblio::RFID::Reader::API
 
-    Search CPAN
-        http://search.cpan.org/dist/RFID-Biblio/
+    You can also look for information at:
 
+    * RT: CPAN's request tracker
+        http://rt.cpan.org/NoAuth/Bugs.html?Dist=Biblio-RFID
 
-LICENSE AND COPYRIGHT
+    * AnnoCPAN: Annotated CPAN documentation
+        http://annocpan.org/dist/Biblio-RFID
+
+    * CPAN Ratings
+        http://cpanratings.perl.org/d/Biblio-RFID
 
-Copyright (C) 2010 Dobrica Pavlinusic
+    * Search CPAN
+        http://search.cpan.org/dist/Biblio-RFID/
+
+ACKNOWLEDGEMENTS
+LICENSE AND COPYRIGHT
+    Copyright 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.