include a summary in documentation and tools

virtualsmartcard/configure.ac

@@ -81,6 +81,10 @@ AC_ARG_ENABLE(confdir,
 	[confdir="${enableval}"], [confdir=/etc/reader.conf.d])
 
 
+PACKAGE_SUMMARY="Smart card emulator written in Python"
+AC_SUBST(PACKAGE_SUMMARY)
+
+
 # Checks for header files.
 AC_CHECK_HEADERS([arpa/inet.h stdint.h stdlib.h string.h sys/socket.h sys/time.h unistd.h])
 

virtualsmartcard/doc/Makefile.am

@@ -5,6 +5,7 @@ do_subst = $(SED) \
 	   -e 's,[@]PACKAGE_TARNAME[@],$(PACKAGE_TARNAME),g' \
 	   -e 's,[@]PACKAGE_BUGREPORT[@],$(PACKAGE_BUGREPORT),g' \
 	   -e 's,[@]PACKAGE_URL[@],$(PACKAGE_URL),g' \
+	   -e 's,[@]PACKAGE_SUMMARY[@],$(PACKAGE_SUMMARY),g' \
 	   -e 's,[@]PACKAGE_VERSION[@],$(PACKAGE_VERSION),g' \
 	   -e 's,[@]RECOMMENDED_CONF_OPTS[@], --sysconfdir=/etc,g' \
 	   -e 's,[@]builddir[@],$(builddir),g' \

virtualsmartcard/doc/README.txt

@@ -14,16 +14,18 @@
 Virtual Smart Card
 ################################################################################
 
-:Authors:
-    - `Frank Morgner <morgner@informatik.hu-berlin.de>`_
-    - `Dominik Oepen <oepen@informatik.hu-berlin.de>`_
-:License:
-    GPL version 3
-:Tested Platforms:
-    - Linux (Debian, Ubuntu, OpenMoko)
-    - Windows (|vpicc| natively, |vpcd| only via Cygwin)
-:Potential Platforms:
-    Unix-like operating systems (Mac OS, Solaris, BSD, ...)
+.. sidebar:: Summary
+
+    Smart card emulator written in Python
+
+  :Authors:
+      - `Frank Morgner <morgner@informatik.hu-berlin.de>`_
+      - `Dominik Oepen <oepen@informatik.hu-berlin.de>`_
+  :License:
+      GPL version 3
+  :Tested Platforms:
+      - Linux (Debian, Ubuntu, OpenMoko)
+      - Windows (|vpicc| natively, |vpcd| only via Cygwin)
 
 Virtual Smart Card emulates a smart card and makes it accessible through PC/SC.
 Currently the Virtual Smart Card supports the following types of smart cards:

virtualsmartcard/doc/README.txt.in

@@ -14,16 +14,18 @@
 @PACKAGE_NAME@
 ################################################################################
 
-:Authors:
-    - `Frank Morgner <morgner@informatik.hu-berlin.de>`_
-    - `Dominik Oepen <oepen@informatik.hu-berlin.de>`_
-:License:
-    GPL version 3
-:Tested Platforms:
-    - Linux (Debian, Ubuntu, OpenMoko)
-    - Windows (|vpicc| natively, |vpcd| only via Cygwin)
-:Potential Platforms:
-    Unix-like operating systems (Mac OS, Solaris, BSD, ...)
+.. sidebar:: Summary
+
+    @PACKAGE_SUMMARY@
+
+  :Authors:
+      - `Frank Morgner <morgner@informatik.hu-berlin.de>`_
+      - `Dominik Oepen <oepen@informatik.hu-berlin.de>`_
+  :License:
+      GPL version 3
+  :Tested Platforms:
+      - Linux (Debian, Ubuntu, OpenMoko)
+      - Windows (|vpicc| natively, |vpcd| only via Cygwin)
 
 @PACKAGE_NAME@ emulates a smart card and makes it accessible through PC/SC.
 Currently the @PACKAGE_NAME@ supports the following types of smart cards:

virtualsmartcard/src/vpicc/Makefile.am

@@ -29,6 +29,7 @@ do_subst = $(SED) \
 		   -e 's,[@]PYTHON[@],$(PYTHON),g' \
 		   -e 's,[@]PACKAGE_VERSION[@],$(PACKAGE_VERSION),g' \
 		   -e 's,[@]PACKAGE_BUGREPORT[@],$(PACKAGE_BUGREPORT),g' \
+		   -e 's,[@]PACKAGE_SUMMARY[@],$(PACKAGE_SUMMARY),g' \
 		   -e 's,[@]PACKAGE_NAME[@],$(PACKAGE_NAME),g'
 
 $(builddir)/vicc: vicc.in Makefile

virtualsmartcard/src/vpicc/vicc.in

@@ -24,7 +24,7 @@ import argparse
 
 parser = argparse.ArgumentParser(
         description='''
-The @PACKAGE_NAME@ emulates different types of smart cards.
+@PACKAGE_SUMMARY@
 
 The emulator connects to the virtual smart card reader reader (vpcd). Smart
 card applications can access the @PACKAGE_NAME@ through the vpcd via PC/SC.