diff --git a/bindings/python/capstone/capstone.py b/bindings/python/capstone/capstone.py
index 1ef666780..e44321a00 100644
--- a/bindings/python/capstone/capstone.py
+++ b/bindings/python/capstone/capstone.py
@@ -82,8 +82,8 @@ CS_OPT_DETAIL = 2    # Break down instruction structure into details
 CS_OPT_MODE = 3      # Change engine's mode at run-time
 
 # Capstone option value
-CS_OPT_OFF = 0             # Turn OFF an option (CS_OPT_DETAIL)
-CS_OPT_ON = 3              # Turn ON an option - this is default option for CS_OPT_DETAIL
+CS_OPT_OFF = 0             # Turn OFF an option - default option of CS_OPT_DETAIL
+CS_OPT_ON = 3              # Turn ON an option (CS_OPT_DETAIL)
 
 # Capstone syntax value
 CS_OPT_SYNTAX_DEFAULT = 0    # Default assembly syntax of all platforms (CS_OPT_SYNTAX)
diff --git a/include/capstone.h b/include/capstone.h
index a6f1275db..5aec27da0 100644
--- a/include/capstone.h
+++ b/include/capstone.h
@@ -73,11 +73,11 @@ typedef enum cs_opt_type {
 
 // Runtime option value (associated with option type above)
 typedef enum cs_opt_value {
-	CS_OPT_OFF = 0,  // Turn OFF an option (CS_OPT_DETAIL)
-	CS_OPT_ON = 3, // Turn ON an option - default option for CS_OPT_DETAIL
+	CS_OPT_OFF = 0,  // Turn OFF an option - default option for CS_OPT_DETAIL.
+	CS_OPT_ON = 3, // Turn ON an option (CS_OPT_DETAIL).
 	CS_OPT_SYNTAX_DEFAULT = 0, // Default asm syntax (CS_OPT_SYNTAX).
 	CS_OPT_SYNTAX_INTEL, // X86 Intel asm syntax - default on X86 (CS_OPT_SYNTAX).
-	CS_OPT_SYNTAX_ATT,   // X86 ATT asm syntax (CS_OPT_SYNTAX)
+	CS_OPT_SYNTAX_ATT,   // X86 ATT asm syntax (CS_OPT_SYNTAX).
 	CS_OPT_SYNTAX_NOREGNAME, // PPC asm syntax: Prints register name with only number (CS_OPT_SYNTAX)
 } cs_opt_value;