doxy: handler

diff --git a/enriched.c b/enriched.c
index c7719f732176584ad569851ea70c905bf0fd4822..78ea05d03f06301af3c678b68ce349c5bf0feaaa 100644 (file)
--- a/enriched.c
+++ b/enriched.c
@@ -448,9 +448,7 @@ static void enriched_set_flags(const wchar_t *tag, struct EnrichedState *stte)
 }
 
 /**
- * text_enriched_handler - Handler for enriched text
- * @param a Body of the email
- * @param s State of text being processed
+ * text_enriched_handler - Handler for enriched text - Implements ::handler_t
  * @retval 0 Always
  */
 int text_enriched_handler(struct Body *a, struct State *s)

diff --git a/handler.c b/handler.c
index 599d3d616b0f24c66ebafa94506edb87edff7f08..07aa1a76b98f1125570f7a0d55d0c60026a7cdfd 100644 (file)
--- a/handler.c
+++ b/handler.c
@@ -69,6 +69,13 @@ char *ShowMultipartAlternative;
 #define TXTPLAIN 2
 #define TXTENRICHED 3
 
+/**
+ * handler_t - Manage a PGP or S/MIME encrypted MIME part
+ * @param m Body of the email
+ * @param s State of text being processed
+ * @retval 0 Success
+ * @retval -1 Error
+ */
 typedef int (*handler_t)(struct Body *b, struct State *s);
 
 /**
@@ -509,11 +516,7 @@ static bool is_autoview(struct Body *b)
 }
 
 /**
- * autoview_handler - Handler for autoviewable attachments
- * @param a Body of the email
- * @param s State of text being processed
- * @retval 0 Success
- * @retval -1 Error
+ * autoview_handler - Handler for autoviewable attachments - Implements ::handler_t
  */
 static int autoview_handler(struct Body *a, struct State *s)
 {
@@ -648,9 +651,7 @@ static int autoview_handler(struct Body *a, struct State *s)
 }
 
 /**
- * text_plain_handler - Handler for plain text
- * @param b Body of email (UNUSED)
- * @param s State to work with
+ * text_plain_handler - Handler for plain text - Implements ::handler_t
  * @retval 0 Always
  *
  * When generating format=flowed ($text_flowed is set) from format=fixed, strip
@@ -681,11 +682,7 @@ static int text_plain_handler(struct Body *b, struct State *s)
 }
 
 /**
- * message_handler - Handler for message/rfc822 body parts
- * @param a Body of the email
- * @param s State of text being processed
- * @retval 0 Success
- * @retval -1 Error
+ * message_handler - Handler for message/rfc822 body parts - Implements ::handler_t
  */
 static int message_handler(struct Body *a, struct State *s)
 {
@@ -737,11 +734,7 @@ static int message_handler(struct Body *a, struct State *s)
 }
 
 /**
- * external_body_handler - Handler for external-body emails
- * @param b Body of the email
- * @param s State of text being processed
- * @retval 0 Success
- * @retval -1 Error
+ * external_body_handler - Handler for external-body emails - Implements ::handler_t
  */
 static int external_body_handler(struct Body *b, struct State *s)
 {
@@ -907,11 +900,7 @@ static int external_body_handler(struct Body *b, struct State *s)
 }
 
 /**
- * alternative_handler - Handler for multipart alternative emails
- * @param a Body of the email
- * @param s State of text being processed
- * @retval 0 Success
- * @retval -1 Error
+ * alternative_handler - Handler for multipart alternative emails - Implements ::handler_t
  */
 static int alternative_handler(struct Body *a, struct State *s)
 {
@@ -1092,9 +1081,7 @@ static int alternative_handler(struct Body *a, struct State *s)
 }
 
 /**
- * multilingual_handler - Handler for multi-lingual emails
- * @param a Body of the email
- * @param s State of text being processed
+ * multilingual_handler - Handler for multi-lingual emails - Implements ::handler_t
  * @retval 0 Always
  */
 static int multilingual_handler(struct Body *a, struct State *s)
@@ -1193,11 +1180,7 @@ static int multilingual_handler(struct Body *a, struct State *s)
 }
 
 /**
- * multipart_handler - Handler for multipart emails
- * @param a Body of the email
- * @param s State of text being processed
- * @retval 0 Success
- * @retval -1 Error
+ * multipart_handler - Handler for multipart emails - Implements ::handler_t
  */
 static int multipart_handler(struct Body *a, struct State *s)
 {
@@ -1275,7 +1258,7 @@ static int multipart_handler(struct Body *a, struct State *s)
  * run_decode_and_handler - Run an appropriate decoder for an email
  * @param b         Body of the email
  * @param s         State to work with
- * @param handler   Callback function to process the content, e.g. rfc3676_handler()
+ * @param handler   Callback function to process the content - Implements ::handler_t
  * @param plaintext Is the content in plain text
  * @retval 0 Success
  * @retval -1 Error
@@ -1415,11 +1398,7 @@ static int run_decode_and_handler(struct Body *b, struct State *s,
 }
 
 /**
- * valid_pgp_encrypted_handler - Handler for valid pgp-encrypted emails
- * @param b Body of the email
- * @param s State to work with
- * @retval 0 Success
- * @retval -1 Error
+ * valid_pgp_encrypted_handler - Handler for valid pgp-encrypted emails - Implements ::handler_t
  */
 static int valid_pgp_encrypted_handler(struct Body *b, struct State *s)
 {
@@ -1431,11 +1410,7 @@ static int valid_pgp_encrypted_handler(struct Body *b, struct State *s)
 }
 
 /**
- * malformed_pgp_encrypted_handler - Handler for invalid pgp-encrypted emails
- * @param b Body of the email
- * @param s State to work with
- * @retval 0 Success
- * @retval -1 Error
+ * malformed_pgp_encrypted_handler - Handler for invalid pgp-encrypted emails - Implements ::handler_t
  */
 static int malformed_pgp_encrypted_handler(struct Body *b, struct State *s)
 {

diff --git a/ncrypt/crypt.c b/ncrypt/crypt.c
index 0f9fedb2a8358ea938937092413d52a1b01524ff..38b4ff3a921b0f1b4fc3d786454b2f3f6d1a2520 100644 (file)
--- a/ncrypt/crypt.c
+++ b/ncrypt/crypt.c
@@ -1061,11 +1061,7 @@ static void crypt_fetch_signatures(struct Body ***signatures, struct Body *a, in
 }
 
 /**
- * mutt_signed_handler - Verify a "multipart/signed" body
- * @param a Body to verify
- * @param s State to use
- * @retval  0 Success
- * @retval -1 Error
+ * mutt_signed_handler - Verify a "multipart/signed" body - Implements ::handler_t
  */
 int mutt_signed_handler(struct Body *a, struct State *s)
 {

diff --git a/ncrypt/cryptglue.c b/ncrypt/cryptglue.c
index 781298cdad2b0be47162b59c9b3056594261d1bb..b627de140a5d283843aa832f24aabb11a82eb50f 100644 (file)
--- a/ncrypt/cryptglue.c
+++ b/ncrypt/cryptglue.c
@@ -199,6 +199,8 @@ int crypt_pgp_decrypt_mime(FILE *a, FILE **b, struct Body *c, struct Body **d)
 
 /**
  * crypt_pgp_application_handler - Wrapper for CryptModuleSpecs::application_handler()
+ *
+ * Implements ::handler_t
  */
 int crypt_pgp_application_handler(struct Body *m, struct State *s)
 {
@@ -210,6 +212,8 @@ int crypt_pgp_application_handler(struct Body *m, struct State *s)
 
 /**
  * crypt_pgp_encrypted_handler - Wrapper for CryptModuleSpecs::encrypted_handler()
+ *
+ * Implements ::handler_t
  */
 int crypt_pgp_encrypted_handler(struct Body *a, struct State *s)
 {
@@ -376,6 +380,8 @@ int crypt_smime_decrypt_mime(FILE *a, FILE **b, struct Body *c, struct Body **d)
 
 /**
  * crypt_smime_application_handler - Wrapper for CryptModuleSpecs::application_handler()
+ *
+ * Implements ::handler_t
  */
 int crypt_smime_application_handler(struct Body *m, struct State *s)
 {

diff --git a/rfc3676.c b/rfc3676.c
index fe48374b39bc29073a6967f608374479efc41d09..df22c17145799fed979871d0e27398bed4394989 100644 (file)
--- a/rfc3676.c
+++ b/rfc3676.c
@@ -305,9 +305,7 @@ static void print_fixed_line(const char *line, struct State *s, int ql, struct F
 }
 
 /**
- * rfc3676_handler - Body handler implementing RFC3676 for format=flowed
- * @param a Body to handle
- * @param s State to use
+ * rfc3676_handler - Body handler implementing RFC3676 for format=flowed - Implements ::handler_t
  * @retval 0 Always
  */
 int rfc3676_handler(struct Body *a, struct State *s)