include a summary in documentation and tools

npa/doc/Makefile.am

@@ -4,6 +4,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[@],,g' \
 	   -e 's,[@]builddir[@],$(builddir),g' \

npa/doc/README.txt

@@ -13,15 +13,17 @@
 nPA Smart Card Library
 ################################################################################
 
-:Author:
-    `Frank Morgner <morgner@informatik.hu-berlin.de>`_
-:License:
-    GPL version 3
-:Tested Platforms:
-    - Windows
-    - Linux (Debian, Ubuntu, OpenMoko)
-:Potential Platforms:
-    Unix-like operating systems (Mac OS, Solaris, BSD, ...)
+.. sidebar:: Summary
+
+    Access the German electronic identity card (neuer Personalausweis/nPA)
+
+    :Author:
+        `Frank Morgner <morgner@informatik.hu-berlin.de>`_
+    :License:
+        GPL version 3
+    :Tested Platforms:
+        - Windows
+        - Linux (Debian, Ubuntu, OpenMoko)
 
 The nPA Smart Card Library offers an easy to use API for the new German identity card
 (neuer Personalausweis, nPA). The library also implements secure messaging,

npa/doc/README.txt.in

@@ -13,15 +13,17 @@
 @PACKAGE_NAME@
 ################################################################################
 
-:Author:
-    `Frank Morgner <morgner@informatik.hu-berlin.de>`_
-:License:
-    GPL version 3
-:Tested Platforms:
-    - Windows
-    - Linux (Debian, Ubuntu, OpenMoko)
-:Potential Platforms:
-    Unix-like operating systems (Mac OS, Solaris, BSD, ...)
+.. sidebar:: Summary
+
+    @PACKAGE_SUMMARY@
+
+    :Author:
+        `Frank Morgner <morgner@informatik.hu-berlin.de>`_
+    :License:
+        GPL version 3
+    :Tested Platforms:
+        - Windows
+        - Linux (Debian, Ubuntu, OpenMoko)
 
 The @PACKAGE_NAME@ offers an easy to use API for the new German identity card
 (neuer Personalausweis, nPA). The library also implements secure messaging,

npa/doc/api.txt

@@ -29,7 +29,7 @@ used to read identity attributes, for example.
 .. note::
     Please consider the following overview to the API as incomplete. The
     `Doxygen documentation <../_static/doxygen-npa/modules.html>`_ should be
-    used as programmer's.
+    used as programmer's reference.
 
 
 ==============================================================