[gnunet] 26/90: -DOC: Numerous small fixes to clean up short warning categories

[gnunet]

This is an automated email from the git hooks/post-receive script.

martin-schanzenbach pushed a commit to branch master
in repository gnunet.

commit e13e66d0dc6a79f6dfe469ba075f307c006fdb66
Author: Willow Liquorice <willow@howhill.com>
AuthorDate: Fri Sep 2 22:13:05 2022 +0100

    -DOC: Numerous small fixes to clean up short warning categories
---
 src/cadet/cadet_api_drop_message.c                    | 2 +-
 src/core/gnunet-service-core_kx.c                     | 3 ++-
 src/include/gnunet_messenger_service.h                | 2 +-
 src/include/gnunet_mq_lib.h                           | 1 +
 src/messenger/gnunet-service-messenger_ego_store.h    | 2 +-
 src/messenger/gnunet-service-messenger_message_kind.h | 2 +-
 src/my/my_result_helper.c                             | 2 +-
 src/reclaim/did.h                                     | 4 ++--
 8 files changed, 10 insertions(+), 8 deletions(-)

diff --git a/src/cadet/cadet_api_drop_message.c 
b/src/cadet/cadet_api_drop_message.c
index 2b031b5c0..e172418c4 100644
--- a/src/cadet/cadet_api_drop_message.c
+++ b/src/cadet/cadet_api_drop_message.c
@@ -27,7 +27,7 @@
 
 
 /**
- * Drop the next cadet message of a given type..
+ * Drop the next cadet message of a given type.
  *
  * @param mq message queue
  * @param ccn client channel number.
diff --git a/src/core/gnunet-service-core_kx.c 
b/src/core/gnunet-service-core_kx.c
index c5992a824..da62b6458 100644
--- a/src/core/gnunet-service-core_kx.c
+++ b/src/core/gnunet-service-core_kx.c
@@ -488,7 +488,8 @@ derive_aes_key (const struct GNUNET_PeerIdentity *sender,
  * @param iv initialization vector to use
  * @param in ciphertext
  * @param out plaintext
- * @param size size of @a in/@a out
+ * @param size size of @a in / @a out
+ *
  * @return #GNUNET_OK on success
  */
 static int
diff --git a/src/include/gnunet_messenger_service.h 
b/src/include/gnunet_messenger_service.h
index f8bbc7398..ff503de52 100644
--- a/src/include/gnunet_messenger_service.h
+++ b/src/include/gnunet_messenger_service.h
@@ -792,7 +792,7 @@ const struct GNUNET_IDENTITY_PublicKey*
 GNUNET_MESSENGER_contact_get_key (const struct GNUNET_MESSENGER_Contact 
*contact);
 
 /**
- * Send a <i>message</i> into a </i>room</i>. If you opened the <i>room</i> 
all entered members will receive the
+ * Send a <i>message</i> into a <i>room</i>. If you opened the <i>room</i> all 
entered members will receive the
  * <i>message</i>. If you entered the <i>room</i> through a <b>door</b> all so 
entered <b>doors</b> will receive the
  * <i>message</i> as well. All members receiving the <i>message</i> will also 
propagate this <i>message</i> recursively
  * as long as the <i>message</i> is unknown to them.
diff --git a/src/include/gnunet_mq_lib.h b/src/include/gnunet_mq_lib.h
index bf2902707..a6bd58558 100644
--- a/src/include/gnunet_mq_lib.h
+++ b/src/include/gnunet_mq_lib.h
@@ -601,6 +601,7 @@ struct GNUNET_MQ_MessageHandler
  *                         "context"),
  *   GNUNET_MQ_handler_end()
  * };
+ * </code>
  *
  * @param name unique basename for the functions
  * @param code message type constant
diff --git a/src/messenger/gnunet-service-messenger_ego_store.h 
b/src/messenger/gnunet-service-messenger_ego_store.h
index 4ed2bbf6d..a08310aa3 100644
--- a/src/messenger/gnunet-service-messenger_ego_store.h
+++ b/src/messenger/gnunet-service-messenger_ego_store.h
@@ -180,7 +180,7 @@ delete_store_ego (struct GNUNET_MESSENGER_EgoStore *store,
 
 /**
  * Updates the location of a registered EGO in a <i>store</i> to
- * a different one under a specific <i>new_identifier<i> replacing
+ * a different one under a specific <i>new_identifier</i> replacing
  * its old one.
  *
  * @param[in/out] store EGO-store
diff --git a/src/messenger/gnunet-service-messenger_message_kind.h 
b/src/messenger/gnunet-service-messenger_message_kind.h
index 508f19074..d07680dfc 100644
--- a/src/messenger/gnunet-service-messenger_message_kind.h
+++ b/src/messenger/gnunet-service-messenger_message_kind.h
@@ -150,7 +150,7 @@ create_message_invite (const struct GNUNET_PeerIdentity 
*door,
                        const struct GNUNET_HashCode *key);
 
 /**
- * Creates and allocates a new <i>text message containing a string 
representing text.
+ * Creates and allocates a new <i>text</i> message containing a string 
representing text.
  * (all values are stored as copy)
  *
  * @param[in] text Text
diff --git a/src/my/my_result_helper.c b/src/my/my_result_helper.c
index 99b4229a4..b80f1c333 100644
--- a/src/my/my_result_helper.c
+++ b/src/my/my_result_helper.c
@@ -531,7 +531,7 @@ pre_extract_string (void *cls,
 
 
 /**
- * Check size of extracted fixed size data from a Mysql database @a
+ * Check size of extracted fixed size data from a Mysql database 
  *
  * @param cls closure
  * @param[in,out] rs
diff --git a/src/reclaim/did.h b/src/reclaim/did.h
index fc465da3b..42f65db26 100644
--- a/src/reclaim/did.h
+++ b/src/reclaim/did.h
@@ -25,7 +25,7 @@
 
 /**
  * Create a DID string from an ego in the format
- * did:gns:<pubkey>
+ * did:gns:\<pubkey\>
  *
  * @param ego the Ego to use
  * @return the DID string
@@ -36,7 +36,7 @@ DID_ego_to_did (struct GNUNET_IDENTITY_Ego *ego);
 
 /**
  * Extract the public key from a DID
- * in the format did:gns:<pubkey>
+ * in the format did:gns:\<pubkey\>
  *
  * @param did the DID parse
  * @param pk where to store the public key

-- 
To stop receiving notification emails like this one, please contact
gnunet@gnunet.org.