Browse Source

Do not treat "DOCDOC" as doxygen.

Nick Mathewson 4 years ago
parent
commit
4895d8288c

+ 2 - 2
src/common/crypto_curve25519.c

@@ -157,7 +157,7 @@ curve25519_keypair_generate(curve25519_keypair_t *keypair_out,
   return 0;
 }
 
-/** DOCDOC */
+/* DOCDOC */
 int
 curve25519_keypair_write_to_file(const curve25519_keypair_t *keypair,
                                  const char *fname,
@@ -180,7 +180,7 @@ curve25519_keypair_write_to_file(const curve25519_keypair_t *keypair,
   return r;
 }
 
-/** DOCDOC */
+/* DOCDOC */
 int
 curve25519_keypair_read_from_file(curve25519_keypair_t *keypair_out,
                                   char **tag_out,

+ 1 - 1
src/common/sandbox.c

@@ -1082,7 +1082,7 @@ sandbox_intern_string(const char *str)
   return str;
 }
 
-/** DOCDOC */
+/* DOCDOC */
 static int
 prot_strings_helper(strmap_t *locations,
                     char **pr_mem_next_p,

+ 1 - 1
src/common/sandbox.h

@@ -152,7 +152,7 @@ int sandbox_cfg_allow_open_filename(sandbox_cfg_t **cfg, char *file);
 int sandbox_cfg_allow_chmod_filename(sandbox_cfg_t **cfg, char *file);
 int sandbox_cfg_allow_chown_filename(sandbox_cfg_t **cfg, char *file);
 
-/**DOCDOC*/
+/* DOCDOC */
 int sandbox_cfg_allow_rename(sandbox_cfg_t **cfg, char *file1, char *file2);
 
 /**

+ 1 - 1
src/or/channel.c

@@ -2868,7 +2868,7 @@ channel_assert_counter_consistency(void)
       (n_channel_bytes_in_queues + n_channel_bytes_passed_to_lower_layer));
 }
 
-/** DOCDOC */
+/* DOCDOC */
 static int
 is_destroy_cell(channel_t *chan,
                 const cell_queue_entry_t *q, circid_t *circid_out)

+ 1 - 1
src/or/channel.h

@@ -182,7 +182,7 @@ struct channel_s {
    * space should we use?
    */
   circ_id_type_bitfield_t circ_id_type:2;
-  /** DOCDOC*/
+  /* DOCDOC */
   unsigned wide_circ_ids:1;
 
   /** For how many circuits are we n_chan?  What about p_chan? */

+ 1 - 1
src/or/circuituse.c

@@ -1674,7 +1674,7 @@ circuit_launch(uint8_t purpose, int flags)
   return circuit_launch_by_extend_info(purpose, NULL, flags);
 }
 
-/** DOCDOC */
+/* DOCDOC */
 static int
 have_enough_path_info(int need_exit)
 {

+ 1 - 1
src/or/connection_edge.c

@@ -904,7 +904,7 @@ connection_ap_mark_as_non_pending_circuit(entry_connection_t *entry_conn)
   smartlist_remove(pending_entry_connections, entry_conn);
 }
 
-/** DOCDOC */
+/* DOCDOC */
 void
 connection_ap_warn_and_unmark_if_pending_circ(entry_connection_t *entry_conn,
                                               const char *where)

+ 1 - 1
src/or/connection_or.h

@@ -100,7 +100,7 @@ var_cell_t *var_cell_new(uint16_t payload_len);
 var_cell_t *var_cell_copy(const var_cell_t *src);
 void var_cell_free(var_cell_t *cell);
 
-/** DOCDOC */
+/* DOCDOC */
 #define MIN_LINK_PROTO_FOR_WIDE_CIRC_IDS 4
 
 #endif

+ 1 - 1
src/or/ext_orport.c

@@ -178,7 +178,7 @@ connection_ext_or_auth_neg_auth_type(connection_t *conn)
   return 1;
 }
 
-/** DOCDOC */
+/* DOCDOC */
 STATIC int
 handle_client_auth_nonce(const char *client_nonce, size_t client_nonce_len,
                          char **client_hash_out,

+ 2 - 2
src/or/or.h

@@ -1358,7 +1358,7 @@ typedef struct listener_connection_t {
  * in the v3 handshake.  The subject key must be a 1024-bit RSA key; it
  * must be signed by the identity key */
 #define OR_CERT_TYPE_AUTH_1024 3
-/** DOCDOC */
+/* DOCDOC */
 #define OR_CERT_TYPE_RSA_ED_CROSSCERT 7
 /**@}*/
 
@@ -3789,7 +3789,7 @@ typedef struct {
                              * and try a new circuit if the stream has been
                              * waiting for this many seconds. If zero, use
                              * our default internal timeout schedule. */
-  int MaxOnionQueueDelay; /**<DOCDOC*/
+  int MaxOnionQueueDelay; /*< DOCDOC */
   int NewCircuitPeriod; /**< How long do we use a circuit before building
                          * a new one? */
   int MaxCircuitDirtiness; /**< Never use circs that were first used more than

+ 1 - 1
src/or/relay.c

@@ -2374,7 +2374,7 @@ packed_cell_mem_cost(void)
   return sizeof(packed_cell_t);
 }
 
-/** DOCDOC */
+/* DOCDOC */
 STATIC size_t
 cell_queues_get_total_allocation(void)
 {

+ 2 - 2
src/or/rendcache.c

@@ -53,7 +53,7 @@ STATIC digestmap_t *rend_cache_v2_dir = NULL;
  * only rely on the usability of intro points from an internal state. */
 STATIC strmap_t *rend_cache_failure = NULL;
 
-/** DOCDOC */
+/* DOCDOC */
 STATIC size_t rend_cache_total_allocation = 0;
 
 /** Initializes the service descriptor cache.
@@ -78,7 +78,7 @@ rend_cache_entry_allocation(const rend_cache_entry_t *e)
   return sizeof(*e) + e->len + sizeof(*e->parsed);
 }
 
-/** DOCDOC */
+/* DOCDOC */
 size_t
 rend_cache_get_total_allocation(void)
 {

+ 1 - 1
src/or/routerkeys.c

@@ -923,7 +923,7 @@ load_ed_keys(const or_options_t *options, time_t now)
   return -1;
 }
 
-/**DOCDOC*/
+/* DOCDOC */
 int
 generate_ed_link_cert(const or_options_t *options, time_t now)
 {

+ 1 - 1
src/or/routerlist.c

@@ -662,7 +662,7 @@ static const char *BAD_SIGNING_KEYS[] = {
   NULL,
 };
 
-/** DOCDOC */
+/* DOCDOC */
 int
 authority_cert_is_blacklisted(const authority_cert_t *cert)
 {