doc: add @file to headers

It's necessary to have a file reference linked in the file list.
Also: strip the top_srcdir from paths

Signed-off-by: Alexander Stein <alexander.stein@mailbox.org>
Signed-off-by: Bartosz Golaszewski <bgolaszewski@baylibre.com>

diff --git a/Doxyfile.in b/Doxyfile.in
index 4abad2d82c5847c5adaf2463725b089f40f7a24c..be2d250e33241bcbc453ed8eae1bdfd1b8ede917 100644 (file)
--- a/Doxyfile.in
+++ b/Doxyfile.in
@@ -22,7 +22,7 @@ BRIEF_MEMBER_DESC      = YES
 REPEAT_BRIEF           = YES
 ALWAYS_DETAILED_SEC    = NO
 FULL_PATH_NAMES        = NO
-STRIP_FROM_PATH        =
+STRIP_FROM_PATH        = @top_srcdir@
 INTERNAL_DOCS          = NO
 STRIP_CODE_COMMENTS    = YES
 CASE_SENSE_NAMES       = YES

diff --git a/bindings/cxx/gpiod.hpp b/bindings/cxx/gpiod.hpp
index 59719aa0d2f4fb08d9af0de60f68d9767c258a4c..8dfc172485d47091270548728188802c4a35e4ec 100644 (file)
--- a/bindings/cxx/gpiod.hpp
+++ b/bindings/cxx/gpiod.hpp
@@ -23,6 +23,10 @@ class line_iter;
 class chip_iter;
 struct line_event;
 
+/**
+ * @file gpiod.hpp
+ */
+
 /**
  * @defgroup gpiod_cxx C++ bindings
  * @{

diff --git a/include/gpiod.h b/include/gpiod.h
index 58de66f764a3ae39b81e13d46268cbcf03065d1b..d1f98308da929d1484b14f9afe941cbca77aec07 100644 (file)
--- a/include/gpiod.h
+++ b/include/gpiod.h
@@ -16,6 +16,10 @@
 extern "C" {
 #endif
 
+/**
+ * @file gpiod.h
+ */
+
 /**
  * @mainpage libgpiod public API
  *