[sr-dev] git:master: cfg.h - config framework - doxygenify documentation

Olle E. Johansson oej at edvina.net
Mon Apr 1 09:13:56 CEST 2013


Module: sip-router
Branch: master
Commit: 709acbb709c43d1b9d391bebf8a99b3bfe3c3e28
URL:    http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=709acbb709c43d1b9d391bebf8a99b3bfe3c3e28

Author: Olle E. Johansson <oej at edvina.net>
Committer: Olle E. Johansson <oej at edvina.net>
Date:   Sat Mar 30 19:01:52 2013 +0100

cfg.h - config framework - doxygenify documentation

---

 cfg/cfg.h |   31 ++++++++++++++-----------------
 1 files changed, 14 insertions(+), 17 deletions(-)

diff --git a/cfg/cfg.h b/cfg/cfg.h
index b85e44e..478d540 100644
--- a/cfg/cfg.h
+++ b/cfg/cfg.h
@@ -36,10 +36,10 @@
 #define CFG_VAR_STR		3U
 #define CFG_VAR_POINTER		4U
 
-/* number of bits required for the variable type */
+/*! \brief number of bits required for the variable type */
 #define CFG_INPUT_SHIFT		3
 
-/* input type */
+/*! \brief input types */
 #define CFG_INPUT_INT		(CFG_VAR_INT << CFG_INPUT_SHIFT)
 #define CFG_INPUT_STRING	(CFG_VAR_STRING << CFG_INPUT_SHIFT)
 #define CFG_INPUT_STR		(CFG_VAR_STR << CFG_INPUT_SHIFT)
@@ -47,28 +47,25 @@
 #define CFG_VAR_MASK(x)		((x)&((1U<<CFG_INPUT_SHIFT)-1))
 #define CFG_INPUT_MASK(x)	((x)&((1U<<(2*CFG_INPUT_SHIFT))-(1U<<CFG_INPUT_SHIFT)))
 
-/* atomic change is allowed */
-#define CFG_ATOMIC		(1U<<(2*CFG_INPUT_SHIFT))
-/* variable is read-only */
-#define CFG_READONLY		(1U<<(2*CFG_INPUT_SHIFT+1))
-/* per-child process callback needs to be called only once */
-#define CFG_CB_ONLY_ONCE	(1U<<(2*CFG_INPUT_SHIFT+2))
+#define CFG_ATOMIC		(1U<<(2*CFG_INPUT_SHIFT))	/*!< atomic change is allowed */
+#define CFG_READONLY		(1U<<(2*CFG_INPUT_SHIFT+1))	/*!< variable is read-only */
+#define CFG_CB_ONLY_ONCE	(1U<<(2*CFG_INPUT_SHIFT+2))	/*!< per-child process callback needs to be called only once */
 
 typedef int (*cfg_on_change)(void *, str *, str *, void **);
 typedef void (*cfg_on_set_child)(str *, str *);
 
-/* strutrure to be used by the module interface */
+/*! \brief structrure to be used by the module interface */
 typedef struct _cfg_def {
 	char	*name;
 	unsigned int	type;
 	int	min;
 	int	max;
-	cfg_on_change	on_change_cb;
+	cfg_on_change		on_change_cb;
 	cfg_on_set_child	on_set_child_cb;
 	char	*descr;
 } cfg_def_t;
 
-/* declares a new cfg group
+/*! \brief declares a new cfg group
  * handler is set to the memory area where the variables are stored
  * return value is -1 on error
  */
@@ -81,33 +78,33 @@ int cfg_declare(char *group_name, cfg_def_t *def, void *values, int def_size,
 #define cfg_get(gname, handle, var) \
 	((struct cfg_group_##gname *)handle)->var
 
-/* declares a single variable with integer type */
+/*! \brief declares a single variable with integer type */
 int cfg_declare_int(char *group_name, char *var_name,
 		int val, int min, int max, char *descr);
 
-/* declares a single variable with str type */
+/*! \brief declares a single variable with str type */
 int cfg_declare_str(char *group_name, char *var_name, char *val, char *descr);
 
-/* Add a varibale to a group instance with integer type.
+/*! \brief Add a variable to a group instance with integer type.
  * The group instance is created if it does not exist.
  * wrapper function for new_add_var()
  */
 int cfg_ginst_var_int(char *group_name, unsigned int group_id, char *var_name,
 			int val);
 
-/* Add a varibale to a group instance with string type.
+/*! \brief Add a variable to a group instance with string type.
  * The group instance is created if it does not exist.
  * wrapper function for new_add_var()
  */
 int cfg_ginst_var_string(char *group_name, unsigned int group_id, char *var_name,
 			char *val);
 
-/* Create a new group instance.
+/*! \brief Create a new group instance.
  * wrapper function for new_add_var()
  */
 int cfg_new_ginst(char *group_name, unsigned int group_id);
 
-/* returns the handle of a cfg group */
+/*! \brief returns the handle of a cfg group */
 void **cfg_get_handle(char *gname);
 
 #endif /* _CFG_H */




More information about the sr-dev mailing list