X-Git-Url: http://pileus.org/git/?a=blobdiff_plain;f=fetchmail.h;h=d759d391e6bbd7d4de651e67d2669b2a08e81922;hb=d31db10231e9ed89f64fdf6e0fb7cae182aa377e;hp=fcab0e597b109a6430dc406c7b10765401e8ec20;hpb=6fdb9350ecdfd0dc7f65975ac9b4d6ba00161b19;p=~andy%2Ffetchmail

diff --git a/fetchmail.h b/fetchmail.h
index fcab0e59..d759d391 100644
--- a/fetchmail.h
+++ b/fetchmail.h
@@ -402,11 +402,11 @@ struct query
     struct query *next;		/* next query control block in chain */
 };
 
-struct msgblk			/* message header parsed for open_sink() */
+struct msgblk			/** message header parsed for open_sink() */
 {
-    char   		*headers;	/* raw message headers */
-    struct idlist	*recipients;	/* addressees */
-    char		return_path[HOSTLEN + USERNAMELEN + 4]; 
+    char   		*headers;	/**< raw message headers */
+    struct idlist	*recipients;	/**< addressees */
+    char		return_path[HOSTLEN + USERNAMELEN + 4]; /**< envelope sender */
     int			msglen;
     int			reallen;
 };
@@ -517,11 +517,14 @@ void resetidletimeout(void);
 int do_protocol(struct query *, const struct method *);
 
 /* transact.c: transaction support */
+/** \ingroup gen_recv_split
+ * Data structure to cache data between \func gen_recv_split calls,
+ * must be initialized before use by calling \func gen_recv_split_init. */
 struct RecvSplit
 {
-    char prefix[100];
-    int cached;
-    char buf[MSGBUFSIZE];
+    char prefix[100];		/**< prefix to match/repeat when splitting lines */
+    int cached;			/**< flag to record if we have data cached in \a buf */
+    char buf[MSGBUFSIZE];	/**< buffer for cached data */
 };
 
 void init_transact(const struct method *);