From 62316163f3110933045e83b9cb10c2410b376bf7 Mon Sep 17 00:00:00 2001
From: Kalle Olavi Niemitalo <kon@iki.fi>
Date: Sat, 18 Jul 2009 23:31:10 +0300
Subject: [PATCH] Comment fixes

---
 src/bfu/button.h                 | 6 +++---
 src/protocol/bittorrent/common.h | 2 +-
 src/session/download.h           | 4 ++--
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/src/bfu/button.h b/src/bfu/button.h
index a1a46cf5..e6e907db 100644
--- a/src/bfu/button.h
+++ b/src/bfu/button.h
@@ -32,7 +32,7 @@ struct widget_info_button {
  * Add a button that will close the dialog if pressed.
  *
  * void add_dlg_ok_button(struct dialog *dlg, unsigned char *text, int flags,
- *                        ::done_handler_T *done, void *done_data);
+ *                        ::done_handler_T *done, void *data);
  *
  * @param dlg
  * The dialog in which the button is to be added.
@@ -50,14 +50,14 @@ struct widget_info_button {
  * Before calling this, BFU checks the values of widgets.
  * After the function returns, BFU closes the dialog.
  *
- * @param done_data
+ * @param data
  * A pointer to be passed to the @a done callback.  */
 
 /** @def add_dlg_button
  * Add a button that need not close the dialog if pressed.
  *
  * void add_dlg_button(struct dialog *dlg, unsigned char *text, int flags,
- *                     ::widget_handler_t *handler, void *data);
+ *                     ::widget_handler_T *handler, void *data);
  *
  * @param handler
  * A function that BFU calls when the user presses this button.
diff --git a/src/protocol/bittorrent/common.h b/src/protocol/bittorrent/common.h
index 287f4ba3..5062b421 100644
--- a/src/protocol/bittorrent/common.h
+++ b/src/protocol/bittorrent/common.h
@@ -32,7 +32,7 @@ struct terminal;
 #define BITTORRENT_REQUEST_LENGTH		(1 << 14)
 
 /** The length of requested blocks of pieces should not exceed 2^17 bytes.
- * Used for the protocol.bittorrent.max_request_length option
+ * Used for the protocol.bittorrent.max_request_length option.
  * Bram uses 2^23 here. */
 #define BITTORRENT_REQUEST_ACCEPT_LENGTH	(1 << 23)
 
diff --git a/src/session/download.h b/src/session/download.h
index 871d3737..0802fac1 100644
--- a/src/session/download.h
+++ b/src/session/download.h
@@ -117,8 +117,8 @@ int are_there_downloads(void);
 /** Whether to resume downloading to a file.  This is a bit mask.
  * Unrecognized bits should be preserved and ignored.  */
 enum download_resume {
-	/** All bits clear.  Downloading cannot be resumed; do not
-	 * offer such an option to the user.  */
+	/** Downloading cannot be resumed; do not offer such an option
+	 * to the user.  All bits clear.  */
 	DOWNLOAD_RESUME_DISABLED = 0,
 
 	/** Downloading can be resumed.  This is the usual value.  */