Comment fixes

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.

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)
 

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.  */