diff --git a/include/capstone.h b/include/capstone.h
index de2c5066bf..f700085ce6 100644
--- a/include/capstone.h
+++ b/include/capstone.h
@@ -105,10 +105,12 @@ typedef enum cs_opt_value {
 } cs_opt_value;
 
 // User-defined callback function for SKIPDATA option
-// @offset: the position of the currently-examining data in the input buffer
-// 		passed to cs_disasm_ex().
+// @code: the input buffer containing code to be disassembled. This is the 
+//      same buffer passed to cs_disasm_ex().
+// @offset: the position of the currently-examining byte in the input
+//      buffer @code mentioned above.
 // @user_data: user-data passed to cs_option() via @user_data field in
-//		cs_opt_skipdata struct below.
+//      cs_opt_skipdata struct below.
 // @return: return number of bytes to skip, or 0 to immediately stop disassembling.
 typedef size_t (*cs_skipdata_cb_t)(const uint8_t *code, size_t offset, void* user_data);