gnunet

commit cc738d28d345bf1e7c4083fc052f4df3be1c2c74
parent 1682f41396022284cd4eebf8f2938143b1b23ec3
Author: Willow Liquorice <willow@howhill.com>
Date:   Sun, 12 Jun 2022 20:30:40 +0100

DOC: Initial work in CADET towards removing redundant doc comments.

Diffstat:
M
src/cadet/gnunet-service-cadet_core.c
 | 
11
-----------
M
src/cadet/gnunet-service-cadet_dht.c
 | 
26
--------------------------

2 files changed, 0 insertions(+), 37 deletions(-)
diff --git a/src/cadet/gnunet-service-cadet_core.c b/src/cadet/gnunet-service-cadet_core.c
@@ -139,14 +139,6 @@ struct RouteDirection
 };
 
 
-/**
- * Description of a segment of a `struct CadetConnection` at the
- * intermediate peers.  Routes are basically entries in a peer's
- * routing table for forwarding traffic.  At both endpoints, the
- * routes are terminated by a `struct CadetConnection`, which knows
- * the complete `struct CadetPath` that is formed by the individual
- * routes.
- */
 struct CadetRoute
 {
   /**
@@ -1321,9 +1313,6 @@ GCO_init (const struct GNUNET_CONFIGURATION_Handle *c)
 }
 
 
-/**
- * Shut down the CORE subsystem.
- */
 void
 GCO_shutdown ()
 {
diff --git a/src/cadet/gnunet-service-cadet_dht.c b/src/cadet/gnunet-service-cadet_dht.c
@@ -55,9 +55,6 @@
 #define LOG(level, ...) GNUNET_log_from (level, "cadet-dht", __VA_ARGS__)
 
 
-/**
- * Handle for DHT searches.
- */
 struct GCD_search_handle
 {
   /**
@@ -215,10 +212,6 @@ announce_id (void *cls)
 }
 
 
-/**
- * Function called by the HELLO subsystem whenever OUR hello
- * changes. Re-triggers the DHT PUT immediately.
- */
 void
 GCD_hello_update ()
 {
@@ -232,11 +225,6 @@ GCD_hello_update ()
 }
 
 
-/**
- * Initialize the DHT subsystem.
- *
- * @param c Configuration.
- */
 void
 GCD_init (const struct GNUNET_CONFIGURATION_Handle *c)
 {
@@ -277,9 +265,6 @@ GCD_init (const struct GNUNET_CONFIGURATION_Handle *c)
 }
 
 
-/**
- * Shut down the DHT subsystem.
- */
 void
 GCD_shutdown (void)
 {
@@ -296,12 +281,6 @@ GCD_shutdown (void)
 }
 
 
-/**
- * Search DHT for paths to @a peeR_id
- *
- * @param peer_id peer to search for
- * @return handle to abort search
- */
 struct GCD_search_handle *
 GCD_search (const struct GNUNET_PeerIdentity *peer_id)
 {
@@ -338,11 +317,6 @@ GCD_search (const struct GNUNET_PeerIdentity *peer_id)
 }
 
 
-/**
- * Stop DHT search started with #GCD_search().
- *
- * @param h handle to search to stop
- */
 void
 GCD_search_stop (struct GCD_search_handle *h)
 {