doxygen comments come before field names

diff --git a/doc/doxyparse.pl b/doc/doxyparse.pl
index c2b04ebce6c9dbd0ab8a6996d86b098c1e93821a..55f0b82052c6714e08f5f3caf2065d68a38969e0 100755 (executable)
--- a/doc/doxyparse.pl
+++ b/doc/doxyparse.pl
@@ -165,6 +165,7 @@ while(<>) {
                ) {
                $struct_description .= "\n.br\n" . $_;
                $key = $2;
+               $struct_description =~ s/\/\*\*\s*(.*)\s*\*\//\\fB$1:\\fR/g;
                $description{$key} = $struct_description;
                $api{$key} = "struct";
                $return{$key} = $1;

diff --git a/doc/function_manpages b/doc/function_manpages
index 48a09e09a2b73c7c7f7fc27d215bf8cad663f8a8..9b10ee30c56917b5370b78badc95f7037dbe37aa 100644 (file)
--- a/doc/function_manpages
+++ b/doc/function_manpages
@@ -106,9 +106,9 @@ ldns_rr2canonical
 ldns_rr_label_count
 
 # packet.h
-#ldns_pkt | ldns_pkt_new, ldns_pkt_id, ldns_pkt_set_flags, ldns_pkt_edns
+ldns_pkt, ldns_pkt_section, ldns_pkt_type | ldns_pkt_new, ldns_pkt_id, ldns_pkt_set_flags, ldns_pkt_edns
 
-ldns_pkt, ldns_pkt_new, ldns_pkt_free, ldns_pkt_print, ldns_pkt_query_new,  ldns_pkt_query_new_frm_str, ldns_pkt_reply_type | ldns_pkt, ldns_pkt_id, ldns_pkt_set_flags, ldns_pkt_edns
+ldns_pkt_new, ldns_pkt_free, ldns_pkt_print, ldns_pkt_query_new,  ldns_pkt_query_new_frm_str, ldns_pkt_reply_type | ldns_pkt
 
 #      gets
 ldns_pkt_id, ldns_pkt_qr, ldns_pkt_aa, ldns_pkt_tc, ldns_pkt_rd, ldns_pkt_cd, ldns_pkt_ra, ldns_pkt_ad, ldns_pkt_opcode, ldns_pkt_rcode, ldns_pkt_qdcount, ldns_pkt_ancount, ldns_pkt_nscount, ldns_pkt_arcount, ldns_pkt_answerfrom, ldns_pkt_when, ldns_pkt_querytime, ldns_pkt_size, ldns_pkt_tsig, ldns_pkt_question, ldns_pkt_answer, ldns_pkt_authority, ldns_pkt_additional, ldns_pkt_xxsection, ldns_pkt_rr_list_by_name, ldns_pkt_rr_list_by_type, ldns_pkt_rr_list_by_name_and_type | ldns_pkt

diff --git a/ldns/packet.h b/ldns/packet.h
index d562f56fbf9b489ece469bddf7d4cdd16aca0d66..33955f45efbf8e7ffe1a7c1a8dd23d6aeacee846 100644 (file)
--- a/ldns/packet.h
+++ b/ldns/packet.h
@@ -93,7 +93,7 @@ struct ldns_struct_pkt
 };
 typedef struct ldns_struct_pkt ldns_pkt;
 
-/*
+/**
  * The sections of a packet
  */
 enum ldns_enum_pkt_section {
@@ -101,12 +101,14 @@ enum ldns_enum_pkt_section {
        LDNS_SECTION_ANSWER = 1,
        LDNS_SECTION_AUTHORITY = 2,
        LDNS_SECTION_ADDITIONAL = 3,
-       LDNS_SECTION_ANY = 4,  /* bogus section, if not interested */
-       LDNS_SECTION_ANY_NOQUESTION = 5 /* used to get all non-question rrs from a packet */
+       /** bogus section, if not interested */
+       LDNS_SECTION_ANY = 4,
+       /** used to get all non-question rrs from a packet */
+       LDNS_SECTION_ANY_NOQUESTION = 5
 };
 typedef enum ldns_enum_pkt_section ldns_pkt_section;   
 
-/*
+/**
  * the different types of packets
  */
 enum ldns_enum_pkt_type {