added autogenerated files for easier development checkout

git-svn-id: https://vsmartcard.svn.sourceforge.net/svnroot/vsmartcard@606 96b47cad-a561-4643-ad3b-153ac7d7599c

pcsc-relay/doc/README.rst

@@ -0,0 +1,71 @@
+.. highlight:: sh
+
+.. _libnfc: http://www.libnfc.org/
+.. _PCSC-lite: http://pcsclite.alioth.debian.org/
+
+
+********************************************************************************
+pcsc-relay
+********************************************************************************
+
+:Authors:
+    - Dominik Oepen <oepen@informatik.hu-berlin.de>
+    - Frank Morgner <morgner@informatik.hu-berlin.de>
+:License:
+    GPL version 3
+:Tested Platforms:
+    Linux (Debian, Ubuntu, OpenMoko)
+:Potential Platforms:
+    - Windows
+    - Unix-like operating systems (Mac OS, Solaris, BSD, ...)
+
+Welcome to pcsc-relay. The purpose of pcsc-relay is to forward APDUs from the
+OpenPICC or from a libnfc device to a smart card via the PCSC middleware. You
+can use this program in combination with the virtual smart card to emulate a
+ISO/IEC 14443 smart card. 
+
+
+.. include:: autotools.rst
+
+pcsc-relay has the following dependencies:
+
+- PC/SC middleware
+- libnfc_
+
+
+---------------
+Hints on libnfc
+---------------
+
+pcsc-relay links against libnfc_. Here is an example of how to get the standard
+installation of the latter::
+ 
+    PREFIX=/tmp/install
+    LIBNFC=libnfc
+    svn co http://libnfc.googlecode.com/svn/trunk $LIBNFC
+    cd $LIBNFC
+    autoreconf -i
+    ./configure --prefix=$PREFIX
+    make
+    make install
+
+Building pcsc-relay with libnfc_ is done best using :command:`pkg-config`.  The file
+:file:`libnfc.pc` should be located in ``$INSTALL/lib/pkgconfig``. Here is how to
+configure pcsc-relay to use it::
+
+    ./configure PKG_CONFIG_PATH=$PREFIX/lib/pkgconfig
+
+
+-------------------------
+Hints on PC/SC middleware
+-------------------------
+
+PC/SC is included by default in most modern operating systems. On Unix-like
+systems (Linux, OS X, Sun OS) it is realized by PCSC-Lite_. To compile
+pcsc-relay you will need to install the PCSC-Lite headers from your
+distribution. Windows also ships with a PC/SC middleware in form of the
+Winscard module. Microsoft's developement environment Visual Studio includes
+all necessary data for building pcsc-relay.
+
+
+.. include:: questions.rst

pcsc-relay/doc/autotools.rst

@@ -0,0 +1,20 @@
+.. highlight:: sh
+
+=============
+Installation
+=============
+
+The pcsc-relay uses the GNU Build System to compile and install. If you are
+unfamiliar with it, please have a look at :file:`INSTALL`. If you have a look
+around and can not find it, you are probably working bleeding edge in the
+repository.  Run the following command in :file:`pcsc-relay` to
+get the missing standard auxiliary files::
+    
+    autoreconf -i
+
+To configure (:command:`configure --help` lists possible options), build and
+install the pcsc-relay now do the following::
+    
+    ./configure
+    make
+    make install

pcsc-relay/doc/questions.rst

@@ -0,0 +1,6 @@
+========
+Question
+========
+
+Do you have questions, suggestions or contributions? Feedback of any kind is
+more than welcome! Please use our `project trackers <http://sourceforge.net/projects/vsmartcard/support>`_.