From b0042a588a932883a8f03e58ffe930c6eb795d48 Mon Sep 17 00:00:00 2001
From: Markus Teich <markus.teich@stusta.mhn.de>
Date: Wed, 23 Nov 2016 23:14:48 +0100
Subject: [PATCH] add doc for test-case function

---
 test_brandt.c | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/test_brandt.c b/test_brandt.c
index d18b17a..1540583 100644
--- a/test_brandt.c
+++ b/test_brandt.c
@@ -364,6 +364,18 @@ run_auction (void *arg)
 }
 
 
+/**
+ * Test a specific auction setup.
+ *
+ * @param[in] n number of bidders.
+ * @param[in] k number of different prices.
+ * @param[in] bids The bid array. Must contain exactly @a n elements each less
+ * than @a k.
+ * @param[in] m If 0 it's a first price auction, else an M+1st price auction
+ * specifying the M.
+ * @param[in] outcome_public 1 means public outcome, 0 means private outcome.
+ * @return 0 on success, 1 on failure
+ */
 static int
 test_auction (uint16_t n,
               uint16_t k,