X-Git-Url: https://www.flypig.org.uk/git/?p=libcontrac.git;a=blobdiff_plain;f=include%2Fcontrac%2Fmatch.h;h=5523eedcc7ed2540201913aadf611bf028411067;hp=fe38c746d4f060f5e874ee022a77459f75a2089c;hb=e48c390a86b448137a87d0d0a5863c202ba66abd;hpb=f8c83387f5abffa94e59332382441a71f5b95545

diff --git a/include/contrac/match.h b/include/contrac/match.h
index fe38c74..5523eed 100644
--- a/include/contrac/match.h
+++ b/include/contrac/match.h
@@ -1,19 +1,29 @@
-/** \ingroup contrac
+/** \ingroup Matching
  * @file
- * @author	David Llewellyn-Jones
+ * @author	David Llewellyn-Jones <david@flypig.co.uk>
  * @version	$(VERSION)
  *
  * @section LICENSE
  *
+ * Copyright David Llewellyn-Jones, 2020
+ * Released under the GPLv2.
  *
- *
- * @brief
+ * @brief Provides a way to match collected RPIs with downloaded DTKs
  * @section DESCRIPTION
  *
+ * This class provides functionality allowing RPIs that have been collected
+ * over Bluetooth to be matched against DTKs downloaded from a Diagnosis
+ * Server.
  *
+ * The list of RPIs and DTKs can be constructed easily using the
+ * \ref Container functions.
  *
  */
 
+/** \addtogroup Matching
+ *  @{
+ */
+
 #ifndef __MATCH_H
 #define __MATCH_H
 
@@ -26,7 +36,18 @@
 
 // Structures
 
+/**
+ * An opaque structure that represents the head of the list.
+ * 
+ * The internal structure can be found in match.c
+ */
 typedef struct _MatchList MatchList;
+
+/**
+ * An opaque structure that represents an item in the list.
+ * 
+ * The internal structure can be found in match.c
+ */
 typedef struct _MatchListItem MatchListItem;
 
 // Function prototypes
@@ -49,4 +70,5 @@ void match_list_find_matches(MatchList * data, RpiList * beacons, DtkList * diag
 
 #endif // __MATCH_H
 
+/** @} addtogroup Matching*/