From 54fdeeefffe31d32dddaf0f3d6a99dc7b3bc2448 Mon Sep 17 00:00:00 2001
From: Uwe Hermann <uwe@hermann-uwe.de>
Date: Sat, 9 Feb 2013 22:10:57 +0100
Subject: [PATCH] Doxygen: Add @file items for the relevant files.

These short descriptions are shown in the "Files" section of the
Doxygen output.
---
 decoder.c         |  6 ++++++
 log.c             |  6 ++++++
 sigrokdecode.h.in | 16 ++++++++++++++++
 version.c         |  6 ++++++
 4 files changed, 34 insertions(+)

diff --git a/decoder.c b/decoder.c
index 52c913a..34e3d95 100644
--- a/decoder.c
+++ b/decoder.c
@@ -23,6 +23,12 @@
 #include "sigrokdecode-internal.h"
 #include <glib.h>
 
+/**
+ * @file
+ *
+ * Listing, loading, unloading, and handling protocol decoders.
+ */
+
 /** @cond PRIVATE */
 
 /* The list of protocol decoders. */
diff --git a/log.c b/log.c
index d6df156..e68014c 100644
--- a/log.c
+++ b/log.c
@@ -23,6 +23,12 @@
 #include <stdarg.h>
 #include <stdio.h>
 
+/**
+ * @file
+ *
+ * Controlling the libsigrokdecode message logging functionality.
+ */
+
 /* Currently selected libsigrokdecode loglevel. Default: SRD_LOG_WARN. */
 static int srd_loglevel = SRD_LOG_WARN; /* Show errors+warnings per default. */
 
diff --git a/sigrokdecode.h.in b/sigrokdecode.h.in
index 033e30e..ca069c5 100644
--- a/sigrokdecode.h.in
+++ b/sigrokdecode.h.in
@@ -30,6 +30,22 @@
 extern "C" {
 #endif
 
+/**
+ * @file
+ *
+ * The public libsigrokdecode header file to be used by frontends.
+ *
+ * This is the only file that libsigrokdecode users (frontends) are supposed
+ * to use and include. There are other header files which get installed with
+ * libsigrokdecode, but those are not meant to be used directly by frontends.
+ *
+ * The correct way to get/use the libsigrokdecode API functions is:
+ *
+ * @code{.c}
+ *   #include <sigrokdecode.h>
+ * @endcode
+ */
+
 /*
  * Package version macros (can be used for conditional compilation).
  */
diff --git a/version.c b/version.c
index 9116574..55ad776 100644
--- a/version.c
+++ b/version.c
@@ -20,6 +20,12 @@
 
 #include "sigrokdecode.h"
 
+/**
+ * @file
+ *
+ * Version number querying functions.
+ */
+
 SRD_API int srd_package_version_major_get(void)
 {
 	return SRD_PACKAGE_VERSION_MAJOR;
-- 
2.30.2