-more documentation fixes

26 files changed, 35 insertions, 64 deletions

diff --git a/src/testing/test_anastasis.c b/src/testing/test_anastasis.c
index 2ff7cb0..9af9911 100644
--- a/src/testing/test_anastasis.c
+++ b/src/testing/test_anastasis.c
@@ -14,7 +14,7 @@
   Anastasis; see the file COPYING.GPL.  If not, see <http://www.gnu.org/licenses/>
 */
 /**
- * @file lib/test_anastasis.c
+ * @file testing/test_anastasis.c
  * @brief testcase to test anastasis
  * @author Christian Grothoff
  * @author Dennis Neufeld
diff --git a/src/testing/test_anastasis_api.c b/src/testing/test_anastasis_api.c
index db18b41..8d40e02 100644
--- a/src/testing/test_anastasis_api.c
+++ b/src/testing/test_anastasis_api.c
@@ -14,7 +14,7 @@
   Anastasis; see the file COPYING.GPL.  If not, see <http://www.gnu.org/licenses/>
 */
 /**
- * @file lib/test_anastasis_api.c
+ * @file testing/test_anastasis_api.c
  * @brief testcase to test anastasis' HTTP API interface
  * @author Christian Grothoff
  * @author Dennis Neufeld
diff --git a/src/testing/testing_api_cmd_config.c b/src/testing/testing_api_cmd_config.c
index 8906261..7ff42c9 100644
--- a/src/testing/testing_api_cmd_config.c
+++ b/src/testing/testing_api_cmd_config.c
@@ -14,7 +14,7 @@
   TALER; see the file COPYING.  If not, see <http://www.gnu.org/licenses/>
 */
 /**
- * @file lib/testing_api_cmd_config.c
+ * @file testing/testing_api_cmd_config.c
  * @brief command to obtain the configuration of an anastasis backend service.
  * @author Dennis Neufeld
  * @author Dominik Meister
diff --git a/src/testing/testing_api_cmd_keyshare_lookup.c b/src/testing/testing_api_cmd_keyshare_lookup.c
index 895d321..efc8c9a 100644
--- a/src/testing/testing_api_cmd_keyshare_lookup.c
+++ b/src/testing/testing_api_cmd_keyshare_lookup.c
@@ -14,7 +14,7 @@
   Anastasis; see the file COPYING.GPL.  If not, see <http://www.gnu.org/licenses/>
 */
 /**
- * @file lib/anastasis_api_keyshare_lookup.c
+ * @file testing/anastasis_api_keyshare_lookup.c
  * @brief Testing of Implementation of the /truth GET
  * @author Christian Grothoff
  * @author Dennis Neufeld
diff --git a/src/testing/testing_api_cmd_policy_lookup.c b/src/testing/testing_api_cmd_policy_lookup.c
index e97f746..0906491 100644
--- a/src/testing/testing_api_cmd_policy_lookup.c
+++ b/src/testing/testing_api_cmd_policy_lookup.c
@@ -14,7 +14,7 @@
   Anastasis; see the file COPYING.GPL.  If not, see <http://www.gnu.org/licenses/>
 */
 /**
- * @file lib/testing_api_cmd_policy_lookup.c
+ * @file testing/testing_api_cmd_policy_lookup.c
  * @brief command to execute the anastasis backend service.
  * @author Dennis Neufeld
  * @author Dominik Meister
diff --git a/src/testing/testing_api_cmd_policy_store.c b/src/testing/testing_api_cmd_policy_store.c
index a8f0a70..d5062c0 100644
--- a/src/testing/testing_api_cmd_policy_store.c
+++ b/src/testing/testing_api_cmd_policy_store.c
@@ -18,7 +18,7 @@
 */
 
 /**
- * @file lib/testing_api_cmd_policy_store.c
+ * @file testing/testing_api_cmd_policy_store.c
  * @brief command to execute the anastasis backend service.
  * @author Christian Grothoff
  * @author Dominik Meister
diff --git a/src/testing/testing_api_cmd_truth_store.c b/src/testing/testing_api_cmd_truth_store.c
index 0883406..40c4d32 100644
--- a/src/testing/testing_api_cmd_truth_store.c
+++ b/src/testing/testing_api_cmd_truth_store.c
@@ -14,7 +14,7 @@
   Anastasis; see the file COPYING.GPL.  If not, see <http://www.gnu.org/licenses/>
 */
 /**
- * @file lib/testing_api_cmd_truth_store.c
+ * @file testing/testing_api_cmd_truth_store.c
  * @brief command to execute the anastasis backend service.
  * @author Dennis Neufeld
  */
diff --git a/src/testing/testing_api_helpers.c b/src/testing/testing_api_helpers.c
index 66e7032..fb3cb48 100644
--- a/src/testing/testing_api_helpers.c
+++ b/src/testing/testing_api_helpers.c
@@ -18,7 +18,7 @@
 */
 
 /**
- * @file lib/testing_api_helpers.c
+ * @file testing/testing_api_helpers.c
  * @brief helper functions for test library.
  * @author Christian Grothoff
  * @author Marcello Stanisci
diff --git a/src/testing/testing_api_trait_account_priv.c b/src/testing/testing_api_trait_account_priv.c
index 4860e82..a40e9d2 100644
--- a/src/testing/testing_api_trait_account_priv.c
+++ b/src/testing/testing_api_trait_account_priv.c
@@ -17,7 +17,7 @@
   <http://www.gnu.org/licenses/>
 */
 /**
- * @file lib/testing_api_trait_account_priv.c
+ * @file testing/testing_api_trait_account_priv.c
  * @brief traits to offer a account_priv
  * @author Christian Grothoff
  */
diff --git a/src/testing/testing_api_trait_account_pub.c b/src/testing/testing_api_trait_account_pub.c
index 5a3632e..19ba79f 100644
--- a/src/testing/testing_api_trait_account_pub.c
+++ b/src/testing/testing_api_trait_account_pub.c
@@ -17,7 +17,7 @@
   <http://www.gnu.org/licenses/>
 */
 /**
- * @file lib/testing_api_trait_account_pub.c
+ * @file testing/testing_api_trait_account_pub.c
  * @brief traits to offer a account_pub
  * @author Christian Grothoff
  */
diff --git a/src/testing/testing_api_trait_code.c b/src/testing/testing_api_trait_code.c
index 1a43cf8..9989dec 100644
--- a/src/testing/testing_api_trait_code.c
+++ b/src/testing/testing_api_trait_code.c
@@ -17,7 +17,7 @@
   <http://www.gnu.org/licenses/>
 */
 /**
- * @file lib/testing_api_trait_string.c
+ * @file testing/testing_api_trait_string.c
  * @brief traits to offers a code for a challenge
  * @author Dominik Meister
  * @author Christian Grothoff
diff --git a/src/testing/testing_api_trait_eks.c b/src/testing/testing_api_trait_eks.c
index dc3f923..f374433 100644
--- a/src/testing/testing_api_trait_eks.c
+++ b/src/testing/testing_api_trait_eks.c
@@ -17,7 +17,7 @@
   <http://www.gnu.org/licenses/>
 */
 /**
- * @file lib/testing_api_trait_eks.c
+ * @file testing/testing_api_trait_eks.c
  * @brief traits to offer a payment identifier
  * @author Dennis Neufeld
  */
diff --git a/src/testing/testing_api_trait_hash.c b/src/testing/testing_api_trait_hash.c
index 18be1ea..fb5015e 100644
--- a/src/testing/testing_api_trait_hash.c
+++ b/src/testing/testing_api_trait_hash.c
@@ -17,7 +17,7 @@
   <http://www.gnu.org/licenses/>
 */
 /**
- * @file lib/testing_api_trait_hash.c
+ * @file testing/testing_api_trait_hash.c
  * @brief traits to offer a hash
  * @author Christian Grothoff
  */
@@ -27,17 +27,9 @@
 #define ANASTASIS_TESTING_TRAIT_HASH "anastasis-hash"
 
 
-/**
- * Obtain a hash from @a cmd.
- *
- * @param cmd command to extract the number from.
- * @param index the number's index number.
- * @param n[out] set to the number coming from @a cmd.
- * @return #GNUNET_OK on success.
- */
 int
-ANASTASIS_TESTING_get_trait_hash
-  (const struct TALER_TESTING_Command *cmd,
+ANASTASIS_TESTING_get_trait_hash (
+  const struct TALER_TESTING_Command *cmd,
   unsigned int index,
   const struct GNUNET_HashCode **h)
 {
@@ -48,16 +40,9 @@ ANASTASIS_TESTING_get_trait_hash
 }
 
 
-/**
- * Offer a hash.
- *
- * @param index the number's index number.
- * @param h the hash to offer.
- * @return #GNUNET_OK on success.
- */
 struct TALER_TESTING_Trait
-ANASTASIS_TESTING_make_trait_hash
-  (unsigned int index,
+ANASTASIS_TESTING_make_trait_hash (
+  unsigned int index,
   const struct GNUNET_HashCode *h)
 {
   struct TALER_TESTING_Trait ret = {
diff --git a/src/testing/testing_api_trait_payment_secret.c b/src/testing/testing_api_trait_payment_secret.c
index 6238879..c885fb7 100644
--- a/src/testing/testing_api_trait_payment_secret.c
+++ b/src/testing/testing_api_trait_payment_secret.c
@@ -17,7 +17,7 @@
   <http://www.gnu.org/licenses/>
 */
 /**
- * @file lib/testing_api_trait_payment_secret.c
+ * @file testing/testing_api_trait_payment_secret.c
  * @brief traits to offer a payment identifier
  * @author Dennis Neufeld
  */
@@ -28,17 +28,9 @@
   "anastasis-payment_secret"
 
 
-/**
- * Obtain an account public key from @a cmd.
- *
- * @param cmd command to extract the payment identifier from.
- * @param index the payment identifier's index number.
- * @param n[out] set to the payment identifier coming from @a cmd.
- * @return #GNUNET_OK on success.
- */
 int
-ANASTASIS_TESTING_get_trait_payment_secret
-  (const struct TALER_TESTING_Command *cmd,
+ANASTASIS_TESTING_get_trait_payment_secret (
+  const struct TALER_TESTING_Command *cmd,
   unsigned int index,
   const struct ANASTASIS_PaymentSecretP **payment_secret)
 {
@@ -49,16 +41,9 @@ ANASTASIS_TESTING_get_trait_payment_secret
 }
 
 
-/**
- * Offer a payment identifier.
- *
- * @param index usually zero
- * @param h the payment identifier to offer.
- * @return #GNUNET_OK on success.
- */
 struct TALER_TESTING_Trait
-ANASTASIS_TESTING_make_trait_payment_secret
-  (unsigned int index,
+ANASTASIS_TESTING_make_trait_payment_secret (
+  unsigned int index,
   const struct ANASTASIS_PaymentSecretP *h)
 {
   struct TALER_TESTING_Trait ret = {
@@ -66,6 +51,7 @@ ANASTASIS_TESTING_make_trait_payment_secret
     .trait_name = ANASTASIS_TESTING_TRAIT_PAYMENT_SECRET,
     .ptr = (const void *) h
   };
+
   return ret;
 }
 
diff --git a/src/testing/testing_api_trait_salt.c b/src/testing/testing_api_trait_salt.c
index c4ceb55..54b9937 100644
--- a/src/testing/testing_api_trait_salt.c
+++ b/src/testing/testing_api_trait_salt.c
@@ -17,7 +17,7 @@
   <http://www.gnu.org/licenses/>
 */
 /**
- * @file lib/testing_api_trait_salt.c
+ * @file testing/testing_api_trait_salt.c
  * @brief traits to offer a hash
  * @author Christian Grothoff
  * @author Dominik Meister
diff --git a/src/testing/testing_api_trait_truth_key.c b/src/testing/testing_api_trait_truth_key.c
index 55094c1..efc1723 100644
--- a/src/testing/testing_api_trait_truth_key.c
+++ b/src/testing/testing_api_trait_truth_key.c
@@ -17,7 +17,7 @@
   <http://www.gnu.org/licenses/>
 */
 /**
- * @file lib/testing_api_trait_truth_key.c
+ * @file testing/testing_api_trait_truth_key.c
  * @brief traits to offer a payment identifier
  * @author Dennis Neufeld
  */
diff --git a/src/testing/testing_api_trait_truth_uuid.c b/src/testing/testing_api_trait_truth_uuid.c
index 6c171fd..eb18d29 100644
--- a/src/testing/testing_api_trait_truth_uuid.c
+++ b/src/testing/testing_api_trait_truth_uuid.c
@@ -17,7 +17,7 @@
   <http://www.gnu.org/licenses/>
 */
 /**
- * @file lib/testing_api_trait_truth_uuid.c
+ * @file testing/testing_api_trait_truth_uuid.c
  * @brief traits to offer a UUID for some truth
  * @author Christian Grothoff
  * @author Dominik Meister
diff --git a/src/testing/testing_cmd_challenge_answer.c b/src/testing/testing_cmd_challenge_answer.c
index bca7d6b..5f0c157 100644
--- a/src/testing/testing_cmd_challenge_answer.c
+++ b/src/testing/testing_cmd_challenge_answer.c
@@ -14,7 +14,7 @@
   Anastasis; see the file COPYING.GPL.  If not, see <http://www.gnu.org/licenses/>
 */
 /**
- * @file lib/testing_cmd_challenge_answer.c
+ * @file testing/testing_cmd_challenge_answer.c
  * @brief command to execute the anastasis recovery service
  * @author Christian Grothoff
  * @author Dennis Neufeld
diff --git a/src/testing/testing_cmd_policy_create.c b/src/testing/testing_cmd_policy_create.c
index 964fb91..7f3b312 100644
--- a/src/testing/testing_cmd_policy_create.c
+++ b/src/testing/testing_cmd_policy_create.c
@@ -14,7 +14,7 @@
   Anastasis; see the file COPYING.GPL.  If not, see <http://www.gnu.org/licenses/>
 */
 /**
- * @file lib/testing_cmd_policy_create.c
+ * @file testing/testing_cmd_policy_create.c
  * @brief command to execute the anastasis secret share service
  * @author Christian Grothoff
  * @author Dennis Neufeld
diff --git a/src/testing/testing_cmd_recover_secret.c b/src/testing/testing_cmd_recover_secret.c
index 6fc3861..5c0f098 100644
--- a/src/testing/testing_cmd_recover_secret.c
+++ b/src/testing/testing_cmd_recover_secret.c
@@ -14,7 +14,7 @@
   Anastasis; see the file COPYING.GPL.  If not, see <http://www.gnu.org/licenses/>
 */
 /**
- * @file lib/testing_cmd_recover_secret.c
+ * @file testing/testing_cmd_recover_secret.c
  * @brief command to execute the anastasis recovery service
  * @author Christian Grothoff
  * @author Dennis Neufeld
diff --git a/src/testing/testing_cmd_secret_share.c b/src/testing/testing_cmd_secret_share.c
index cecfd86..3b8c3b2 100644
--- a/src/testing/testing_cmd_secret_share.c
+++ b/src/testing/testing_cmd_secret_share.c
@@ -14,7 +14,7 @@
   Anastasis; see the file COPYING.GPL.  If not, see <http://www.gnu.org/licenses/>
 */
 /**
- * @file lib/testing_cmd_secret_share.c
+ * @file testing/testing_cmd_secret_share.c
  * @brief command to execute the anastasis secret share service
  * @author Christian Grothoff
  * @author Dennis Neufeld
diff --git a/src/testing/testing_cmd_truth_upload.c b/src/testing/testing_cmd_truth_upload.c
index 87dec9d..233905a 100644
--- a/src/testing/testing_cmd_truth_upload.c
+++ b/src/testing/testing_cmd_truth_upload.c
@@ -14,7 +14,7 @@
   Anastasis; see the file COPYING.GPL.  If not, see <http://www.gnu.org/licenses/>
 */
 /**
- * @file lib/testing_cmd_truth_upload.c
+ * @file testing/testing_cmd_truth_upload.c
  * @brief command to execute the anastasis secret share service
  * @author Christian Grothoff
  * @author Dennis Neufeld
diff --git a/src/testing/testing_trait_challenge.c b/src/testing/testing_trait_challenge.c
index da981d7..dc82f9a 100644
--- a/src/testing/testing_trait_challenge.c
+++ b/src/testing/testing_trait_challenge.c
@@ -17,7 +17,7 @@
   <http://www.gnu.org/licenses/>
 */
 /**
- * @file lib/testing_trait_challenge.c
+ * @file testing/testing_trait_challenge.c
  * @brief traits to offer a challenge
  * @author Christian Grothoff
  * @author Dominik Meister
diff --git a/src/testing/testing_trait_core_secret.c b/src/testing/testing_trait_core_secret.c
index 98eb0db..b3dec63 100644
--- a/src/testing/testing_trait_core_secret.c
+++ b/src/testing/testing_trait_core_secret.c
@@ -17,7 +17,7 @@
   <http://www.gnu.org/licenses/>
 */
 /**
- * @file lib/testing_trait_core_secret.c
+ * @file testing/testing_trait_core_secret.c
  * @brief traits to offer the core secret
  * @author Christian Grothoff
  * @author Dominik Meister
diff --git a/src/testing/testing_trait_policy.c b/src/testing/testing_trait_policy.c
index 1a6e572..8cf1d76 100644
--- a/src/testing/testing_trait_policy.c
+++ b/src/testing/testing_trait_policy.c
@@ -17,7 +17,7 @@
   <http://www.gnu.org/licenses/>
 */
 /**
- * @file lib/testing_trait_policy.c
+ * @file testing/testing_trait_policy.c
  * @brief traits to offer a policy
  * @author Christian Grothoff
  * @author Dominik Meister
diff --git a/src/testing/testing_trait_truth.c b/src/testing/testing_trait_truth.c
index 36b33d6..3ef9dd8 100644
--- a/src/testing/testing_trait_truth.c
+++ b/src/testing/testing_trait_truth.c
@@ -17,7 +17,7 @@
   <http://www.gnu.org/licenses/>
 */
 /**
- * @file lib/testing_trait_truth.c
+ * @file testing/testing_trait_truth.c
  * @brief traits to offer a truth
  * @author Christian Grothoff
  * @author Dominik Meister