loader: Fix comments in struct ast_module.

Make the comments follow doxygen format, move comments to the line
before each field they describe.

Change-Id: Ic445468398b5e88f13910f7c2f70bd15aad33a27

diff --git a/main/loader.c b/main/loader.c
index 7b7066f9f122a1d713d1fa8b578aaf2a90f05ae3..7d792b08e47f7a53b76509f52e0efba6d6c2fb86 100644 (file)
--- a/main/loader.c
+++ b/main/loader.c
@@ -120,15 +120,21 @@ static int modules_loaded;
 struct ast_module {
        const struct ast_module_info *info;
 #ifdef REF_DEBUG
-       /* Used to get module references into REF_DEBUG logs */
+       /*! Used to get module references into refs log */
        void *ref_debug;
 #endif
-       void *lib;                                      /* the shared lib, or NULL if embedded */
-       int usecount;                                   /* the number of 'users' currently in this module */
-       struct module_user_list users;                  /* the list of users in the module */
+       /*! The shared lib. */
+       void *lib;
+       /*! Number of 'users' and other references currently holding the module. */
+       int usecount;
+       /*! List of users holding the module. */
+       struct module_user_list users;
        struct {
+               /*! The module running and ready to accept requests. */
                unsigned int running:1;
+               /*! The module has declined to start. */
                unsigned int declined:1;
+               /*! This module is being held open until it's time to shutdown. */
                unsigned int keepuntilshutdown:1;
        } flags;
        AST_LIST_ENTRY(ast_module) list_entry;