convert existing comments to doxygen format

git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@23492 65c4cc65-6c06-0410-ace0-fbb531ad65f3

diff --git a/pbx/pbx_dundi.c b/pbx/pbx_dundi.c
index ce48bfeb6530458e9ded05ca5af4308ba2aa1756..45a149c8cff58424bf424b0c284102cb9e71e9f6 100644 (file)
--- a/pbx/pbx_dundi.c
+++ b/pbx/pbx_dundi.c
@@ -86,16 +86,16 @@ extern char ast_config_AST_KEY_DIR[];
 #define DUNDI_MODEL_OUTBOUND   (1 << 1)
 #define DUNDI_MODEL_SYMMETRIC  (DUNDI_MODEL_INBOUND | DUNDI_MODEL_OUTBOUND)
 
-/* Keep times of last 10 lookups */
+/*! Keep times of last 10 lookups */
 #define DUNDI_TIMING_HISTORY   10
 
-#define FLAG_ISREG             (1 << 0)                /* Transaction is register request */
-#define FLAG_DEAD              (1 << 1)                /* Transaction is dead */
-#define FLAG_FINAL             (1 << 2)                /* Transaction has final message sent */
-#define FLAG_ISQUAL            (1 << 3)                /* Transaction is a qualification */
-#define FLAG_ENCRYPT   (1 << 4)                /* Transaction is encrypted wiht ECX/DCX */
-#define FLAG_SENDFULLKEY       (1 << 5)                /* Send full key on transaction */
-#define FLAG_STOREHIST (1 << 6)                /* Record historic performance */
+#define FLAG_ISREG       (1 << 0)   /*!< Transaction is register request */
+#define FLAG_DEAD        (1 << 1)   /*!< Transaction is dead */
+#define FLAG_FINAL       (1 << 2)   /*!< Transaction has final message sent */
+#define FLAG_ISQUAL      (1 << 3)   /*!< Transaction is a qualification */
+#define FLAG_ENCRYPT     (1 << 4)   /*!< Transaction is encrypted wiht ECX/DCX */
+#define FLAG_SENDFULLKEY (1 << 5)   /*!< Send full key on transaction */
+#define FLAG_STOREHIST   (1 << 6)   /*!< Record historic performance */
 
 #define DUNDI_FLAG_INTERNAL_NOPARTIAL (1 << 17)
 
@@ -166,31 +166,31 @@ struct dundi_precache_queue {
 struct dundi_request;
 
 struct dundi_transaction {
-       struct sockaddr_in addr;        /* Other end of transaction */
-       struct timeval start;           /* When this transaction was created */
+       struct sockaddr_in addr;               /*!< Other end of transaction */
+       struct timeval start;                  /*!< When this transaction was created */
        dundi_eid eids[DUNDI_MAX_STACK + 1];
-       int eidcount;                           /* Number of eids in eids */
-       dundi_eid us_eid;                       /* Our EID, to them */
-       dundi_eid them_eid;                     /* Their EID, to us */
-       aes_encrypt_ctx ecx;            /* AES 128 Encryption context */
-       aes_decrypt_ctx dcx;            /* AES 128 Decryption context */
-       unsigned int flags;                             /* Has final packet been sent */
-       int ttl;                                        /* Remaining TTL for queries on this one */
-       int thread;                                     /* We have a calling thread */
-       int retranstimer;                       /* How long to wait before retransmissions */
-       int autokillid;                         /* ID to kill connection if answer doesn't come back fast enough */
-       int autokilltimeout;            /* Recommended timeout for autokill */
-       unsigned short strans;          /* Our transaction identifier */
-       unsigned short dtrans;          /* Their transaction identifer */
-       unsigned char iseqno;           /* Next expected received seqno */
-       unsigned char oiseqno;          /* Last received incoming seqno */
-       unsigned char oseqno;           /* Next transmitted seqno */
-       unsigned char aseqno;           /* Last acknowledge seqno */
-       struct dundi_packet *packets;   /* Packets to be retransmitted */
-       struct dundi_packet *lasttrans; /* Last transmitted / ACK'd packet */
-       struct dundi_transaction *next; /* Next with respect to the parent */
-       struct dundi_request *parent;   /* Parent request (if there is one) */
-       struct dundi_transaction *allnext; /* Next with respect to all DUNDi transactions */
+       int eidcount;                          /*!< Number of eids in eids */
+       dundi_eid us_eid;                      /*!< Our EID, to them */
+       dundi_eid them_eid;                    /*!< Their EID, to us */
+       aes_encrypt_ctx ecx;                   /*!< AES 128 Encryption context */
+       aes_decrypt_ctx dcx;                   /*!< AES 128 Decryption context */
+       unsigned int flags;                    /*!< Has final packet been sent */
+       int ttl;                               /*!< Remaining TTL for queries on this one */
+       int thread;                            /*!< We have a calling thread */
+       int retranstimer;                      /*!< How long to wait before retransmissions */
+       int autokillid;                        /*!< ID to kill connection if answer doesn't come back fast enough */
+       int autokilltimeout;                   /*!< Recommended timeout for autokill */
+       unsigned short strans;                 /*!< Our transaction identifier */
+       unsigned short dtrans;                 /*!< Their transaction identifer */
+       unsigned char iseqno;                  /*!< Next expected received seqno */
+       unsigned char oiseqno;                 /*!< Last received incoming seqno */
+       unsigned char oseqno;                  /*!< Next transmitted seqno */
+       unsigned char aseqno;                  /*!< Last acknowledge seqno */
+       struct dundi_packet *packets;          /*!< Packets to be retransmitted */
+       struct dundi_packet *lasttrans;        /*!< Last transmitted / ACK'd packet */
+       struct dundi_transaction *next;        /*!< Next with respect to the parent */
+       struct dundi_request *parent;          /*!< Parent request (if there is one) */
+       struct dundi_transaction *allnext;     /*!< Next with respect to all DUNDi transactions */
 } *alltrans;
 
 struct dundi_request {
@@ -206,8 +206,8 @@ struct dundi_request {
        int expiration;
        int cbypass;
        int pfds[2];
-       unsigned long crc32;                                                    /* CRC-32 of all but root EID's in avoid list */
-       struct dundi_transaction *trans;        /* Transactions */
+       unsigned long crc32;                   /*!< CRC-32 of all but root EID's in avoid list */
+       struct dundi_transaction *trans;       /*!< Transactions */
        struct dundi_request *next;
 } *requests;