add comments

diff --git a/compress.c b/compress.c
index eb7638cea8725210a65c7e738bb7569edcffba22..899fdeea563a4bc9dd599fa652e1d01ee2950012 100644 (file)
--- a/compress.c
+++ b/compress.c
@@ -25,6 +25,11 @@
  * @page compress Compressed mbox local mailbox type
  *
  * Compressed mbox local mailbox type
+ *
+ * @note
+ * Any references to compressed files also apply to encrypted files.
+ * - mailbox->path     == plaintext file
+ * - mailbox->realpath == compressed file
  */
 
 #include "config.h"
@@ -50,12 +55,6 @@
 
 struct Email;
 
-/* Notes:
- * Any references to compressed files also apply to encrypted files.
- * - mailbox->path     == plaintext file
- * - mailbox->realpath == compressed file
- */
-
 /**
  * struct CompressInfo - Private data for compress
  *

diff --git a/conn/connaccount.h b/conn/connaccount.h
index 5651f433246b07abf08aefd6cec5b0a632a10f05..22df52d440654a0f1d9a21482056971847b607aa 100644 (file)
--- a/conn/connaccount.h
+++ b/conn/connaccount.h
@@ -33,8 +33,8 @@ struct ConnAccount
   char pass[256];
   char host[128];
   unsigned short port;
-  unsigned char type;
-  unsigned char flags;
+  unsigned char type;  ///< Connection type, e.g. #MUTT_ACCT_TYPE_IMAP
+  unsigned char flags; ///< Which fields are initialised, e.g. #MUTT_ACCT_USER
 };
 
 #endif /* MUTT_CONN_ACCOUNT_H */

diff --git a/conn/connection.h b/conn/connection.h
index 6a392393c75f90ced8866d1cf250aff3eb6adbb2..c412325277da1d224d1d79d9bbe1f0cdadeace80 100644 (file)
--- a/conn/connection.h
+++ b/conn/connection.h
@@ -36,7 +36,7 @@ struct Connection
 {
   struct ConnAccount account;
   unsigned int ssf; /**< security strength factor, in bits */
-  void *data;
+  void *data; /** mostly Mailbox ptr, else NNTP Server */
 
   char inbuf[LONG_STRING];
   int bufpos;

diff --git a/imap/imap_private.h b/imap/imap_private.h
index 487b8c51f8487410d83157bb10f42780cd072229..ddcc1736bc927500fa636a127b6249a21cda34dc 100644 (file)
--- a/imap/imap_private.h
+++ b/imap/imap_private.h
@@ -210,8 +210,8 @@ struct ImapMboxData
 {
   struct Connection *conn;
   bool recovering;
-  unsigned char state;
-  unsigned char status;
+  unsigned char state;  ///< ImapState, e.g. #IMAP_AUTHENTICATED
+  unsigned char status; ///< ImapFlags, e.g. #IMAP_FATAL
   /* let me explain capstr: SASL needs the capability string (not bits).
    * we have 3 options:
    *   1. rerun CAPABILITY inside SASL function.
@@ -249,8 +249,8 @@ struct ImapMboxData
   char delim;
   struct Context *ctx;
   char *mbox_name;
-  unsigned short check_status;
-  unsigned char reopen;
+  unsigned short check_status; /**< Flags, e.g. #IMAP_NEWMAIL_PENDING */
+  unsigned char reopen;        /**< Flags, e.g. #IMAP_REOPEN_ALLOW */
   unsigned int new_mail_count; /**< Set when EXISTS notifies of new mail */
   struct ImapCache cache[IMAP_CACHE_LEN];
   struct Hash *uid_hash;

diff --git a/mailbox.h b/mailbox.h
index 8b687762f7d6eec6dd6109a441bbe4347a6593b1..5311758d033ebba56b254b04bc6ffebae8813f68 100644 (file)
--- a/mailbox.h
+++ b/mailbox.h
@@ -41,8 +41,8 @@ extern short MailCheckStatsInterval;
 extern bool  MaildirCheckCur;
 
 /* parameter to mutt_parse_mailboxes */
-#define MUTT_NAMED   1
-#define MUTT_VIRTUAL 2
+#define MUTT_NAMED   (1 << 0)
+#define MUTT_VIRTUAL (1 << 1)
 
 #define MB_NORMAL 0
 #define MB_HIDDEN 1