include/: tidy up header files

diff --git a/include/common/buf.h b/include/common/buf.h
index f732bb5f287ff873a4958d5564725eabefba2836..98be625d39b2179f819166ae717202acbc1fe472 100644 (file)
--- a/include/common/buf.h
+++ b/include/common/buf.h
@@ -17,14 +17,14 @@ struct buf {
        int len;
 };
 
-/*
+/**
  * buf_init - allocate NULL-terminated C string buffer
  * @s - buffer
  * Note: use free(s->buf) to free it.
  */
 void buf_init(struct buf *s);
 
-/*
+/**
  * buf_add - add data to C string buffer
  * @s - buffer
  * @data - data to be added

diff --git a/include/common/bug-on.h b/include/common/bug-on.h
index aa5f7f3ffdbb5e1f15f1dfeb7709f0a3bad11d60..1b25c80357ea1e7077ddb06e555dc64aac333c02 100644 (file)
--- a/include/common/bug-on.h
+++ b/include/common/bug-on.h
@@ -1,7 +1,7 @@
 #ifndef __LABWC_BUG_ON_H
 #define __LABWC_BUG_ON_H
 
-/*
+/**
  * BUG_ON - assert() without abort()
  * @condition - expression to be evaluated
  */

diff --git a/include/common/font.h b/include/common/font.h
index 04f99f0978c0f285d5773ec0d975ec31949612ca..9832c667ff13dcd07853c7239b7b16f7f009f5a4 100644 (file)
--- a/include/common/font.h
+++ b/include/common/font.h
@@ -1,7 +1,7 @@
 #ifndef __LABWC_FONT_H
 #define __LABWC_FONT_H
 
-/*
+/**
  * font_height - get font vertical extents
  * @font_description: string describing font, for example 'sans 10'
  */

diff --git a/include/config/keybind.h b/include/config/keybind.h
index ce57caf71ebadff38784b5b767a7bbf024f0c099..8742ca48583e0215c6f5de16bc577f674a5ffd21 100644 (file)
--- a/include/config/keybind.h
+++ b/include/config/keybind.h
@@ -13,6 +13,10 @@ struct keybind {
        struct wl_list link;
 };
 
+/**
+ * keybind_add - parse keybind and add to linked list
+ * @keybind: key combination
+ */
 struct keybind *keybind_add(const char *keybind);
 
 #endif /* __LABWC_KEYBIND_H */

diff --git a/include/labwc.h b/include/labwc.h
index c3a3a6157f6bb0a6a4504655aa3dc984e709d272..e5ebb1e044dda7e84f8d7f9647ba92c22299ebe2 100644 (file)
--- a/include/labwc.h
+++ b/include/labwc.h
@@ -149,7 +149,6 @@ void view_init_position(struct view *view);
 struct wlr_box view_get_surface_geometry(struct view *view);
 struct wlr_box view_geometry(struct view *view);
 void view_resize(struct view *view, struct wlr_box geo);
-bool view_want_deco(struct view *view);
 void view_focus(struct view *view);
 struct view *view_front_toplevel(struct server *server);
 struct view *next_toplevel(struct view *current);

diff --git a/include/theme/theme-dir.h b/include/theme/theme-dir.h
index 9ebb09af7c7829566551c27ab2bc0669ee5e07f8..310e60779a844807d6a54b96ede1ceb8930ad9f3 100644 (file)
--- a/include/theme/theme-dir.h
+++ b/include/theme/theme-dir.h
@@ -1,6 +1,10 @@
 #ifndef __LABWC_THEME_DIR_H
 #define __LABWC_THEME_DIR_H
 
+/**
+ * theme_dir - find theme directory containing theme @theme_name
+ * @theme_name: theme to search for
+ */
 char *theme_dir(const char *theme_name);
 
 #endif /* __LABWC_THEME_DIR_H */

diff --git a/include/theme/theme.h b/include/theme/theme.h
index 6833c07969ebbae78c7fd94cb6df05440748a0e4..1478624ed3b7ff947e5fb5b2bf255c997061db8c 100644 (file)
--- a/include/theme/theme.h
+++ b/include/theme/theme.h
@@ -21,6 +21,11 @@ struct theme {
 
 extern struct theme theme;
 
+/**
+ * theme_read - read theme into global theme struct
+ * @theme_name: theme-name in <theme-dir>/<theme-name>/openbox-3/themerc
+ * Note <theme-dir> is obtained in theme-dir.c
+ */
 void theme_read(const char *theme_name);
 
 #endif /* __LABWC_THEME_H */