massively improved build system

src/version.cxx

@@ -18,19 +18,22 @@ namespace NAMESPACE {
     return PACKAGE_VERSION;
   }
   std::string build_date() {
-    return BUILD_DATE_STR;
+    return BUILD_DATE;
   }
   std::string author() {
-    return AUTHOR_STR;
+    return AUTHOR;
   }
   std::string description() {
-    return README_STR;
+    return DESCRIPTION;
+  }
+  std::string readme() {
+    return README;
   }
   std::string logo() {
-    return PROJECT_LOGO_STR;
+    return PROJECT_LOGO;
   }
   std::string icon() {
-    return PROJECT_ICON_STR;
+    return PROJECT_ICON;
   }
   const std::string WHAT("#(@) " PACKAGE_STRING);
   const std::string IDENT("$Id: " PACKAGE_STRING);

src/version.hxx

@@ -1,6 +1,6 @@
 /*! @file
 
-    @id $
+    @id $Id$
 */
 //       1         2         3         4         5         6         7         8
 // 45678901234567890123456789012345678901234567890123456789012345678901234567890
@@ -8,14 +8,26 @@
 #include <string>
 
 namespace NAMESPACE {
+  /// get package string which consists of package name and package version
   std::string package_string();
+  /// get package name
   std::string package_name();
+  /// get package version
   std::string version();
+  /// get code build date
   std::string build_date();
+  /// get author, i.e. copyright holder
   std::string author();
+  /// get short package description (1st line of README)
   std::string description();
+  /// get long package description (starting at 3rd line in README)
+  std::string readme();
+  /// get package logo file name
   std::string logo();
+  /// get package icon file name
   std::string icon();
+  /// used for <code>what filename</code>
   extern const std::string WHAT;
+  /// used for <code>ident filename</code>
   extern const std::string IDENT;
 }

src/webrunner.cxx

@@ -45,6 +45,8 @@ QString help(const Script& s) {
     <<std::endl
     <<format(description()).toStdString()<<std::endl
     <<std::endl
+    <<format(readme()).toStdString()<<std::endl
+    <<std::endl
     <<"SCRIPT SYNTAX"<<std::endl
     <<std::endl
     <<format(s.syntax()).toStdString()<<std::endl