From 8de6253e671bff221dd61960d90a35873a7f48b4 Mon Sep 17 00:00:00 2001
From: frankmorgner <frankmorgner@96b47cad-a561-4643-ad3b-153ac7d7599c>
Date: Thu, 27 Oct 2011 11:24:33 +0000
Subject: [PATCH] more information for installation

git-svn-id: https://vsmartcard.svn.sourceforge.net/svnroot/vsmartcard@580 96b47cad-a561-4643-ad3b-153ac7d7599c
---
 pcsc-relay/README | 54 +++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 52 insertions(+), 2 deletions(-)

diff --git a/pcsc-relay/README b/pcsc-relay/README
index a7af19a..a07cee5 100644
--- a/pcsc-relay/README
+++ b/pcsc-relay/README
@@ -1,3 +1,8 @@
+.. highlight:: sh
+
+.. _libnfc: http://www.libnfc.org/
+.. _PCSC-lite: http://pcsclite.alioth.debian.org/
+
 **********
 pcsc-relay
 **********
@@ -13,12 +18,57 @@ can use this program in combination with the virtual smart card to emulate a
 ISO/IEC 14443 smart card. 
 
 
+============
 Installation
-------------
+============
 
-See file INSTALL.
+pcsc-relay uses the GNU Build System to compile and install. If you are
+unfamiliar with it, please have a look at the 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 the pcsc-relay direcotry to get the
+missing standard auxiliary files::
+    
+    autoreconf -i
 
+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 ``pkg-config``.  The 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.
+
+---------
 Questions
 ---------