branches/zip: Fix some function comments.

include/dict0dict.h

@@ -440,8 +440,8 @@ dict_foreign_find_equiv_index(
 				foreign->foreign_index, or NULL */
 	dict_foreign_t*	foreign);/* in: foreign key */
 /**************************************************************************
-Returns an index object by matching on the name and column names and if
-more than index is found return the index with the higher id.*/
+Returns an index object by matching on the name and column names and
+if more than one index matches return the index with the max id */
 UNIV_INTERN
 dict_index_t*
 dict_table_get_index_by_max_id(

include/os0file.h

@@ -614,11 +614,14 @@ os_aio(
 	ulint		offset_high, /* in: most significant 32 bits of
 				offset */
 	ulint		n,	/* in: number of bytes to read or write */
-	fil_node_t*	message1,/* in: messages for the aio handler (these
-				can be used to identify a completed aio
-				operation); if mode is OS_AIO_SYNC, these
-				are ignored */
-	void*		message2);
+	fil_node_t*	message1,/* in: message for the aio handler
+				(can be used to identify a completed
+				aio operation); ignored if mode is
+				OS_AIO_SYNC */
+	void*		message2);/* in: message for the aio handler
+				(can be used to identify a completed
+				aio operation); ignored if mode is
+				OS_AIO_SYNC */
 /****************************************************************************
 Wakes up all async i/o threads so that they know to exit themselves in
 shutdown. */

include/trx0sys.h

@@ -84,7 +84,7 @@ UNIV_INTERN
 void
 trx_sys_doublewrite_init_or_restore_pages(
 /*======================================*/
-	ibool	restore_corrupt_pages);
+	ibool	restore_corrupt_pages);	/* in: TRUE=restore pages */
 /********************************************************************
 Marks the trx sys header when we have successfully upgraded to the >= 4.1.x
 multiple tablespace format. */

os/os0file.c

@@ -3371,11 +3371,14 @@ os_aio(
 	ulint		offset_high, /* in: most significant 32 bits of
 				offset */
 	ulint		n,	/* in: number of bytes to read or write */
-	fil_node_t*	message1,/* in: messages for the aio handler (these
-				can be used to identify a completed aio
-				operation); if mode is OS_AIO_SYNC, these
-				are ignored */
-	void*		message2)
+	fil_node_t*	message1,/* in: message for the aio handler
+				(can be used to identify a completed
+				aio operation); ignored if mode is
+				OS_AIO_SYNC */
+	void*		message2)/* in: message for the aio handler
+				(can be used to identify a completed
+				aio operation); ignored if mode is
+				OS_AIO_SYNC */
 {
 	os_aio_array_t*	array;
 	os_aio_slot_t*	slot;

trx/trx0sys.c

@@ -403,7 +403,7 @@ UNIV_INTERN
 void
 trx_sys_doublewrite_init_or_restore_pages(
 /*======================================*/
-	ibool	restore_corrupt_pages)
+	ibool	restore_corrupt_pages)	/* in: TRUE=restore pages */
 {
 	byte*	buf;
 	byte*	read_buf;