improve documentation style

Author: roman_yakovenko

docs/pygccxml.rest

@@ -56,7 +56,7 @@ Only 1 ( one ) line of code is needed:
   #global_ns is the reference to declarations, which describes global( :: ) namespace
   global_ns.free_functions( "do_smth", return_type='void', arg_types=[None,'int'] )
 
-``None`` means "any type". In my opinion the code is prety clear and readable.
+``None`` means "any type". In my opinion, the code is prety clear and readable.
 
 If you want to know more about provided API read `query interface`__ document or 
 API documentation.

docs/query_interface.rest

@@ -25,8 +25,8 @@ a reference to an integer. More over, I want those functions names to end with
   global_ns.member_functions( function=query, arg_types=[None, 'int &'] )
 
 The example is complex, but still readable. In many cases you will find 
-yourself looking for one or many declarations using one or two properties of that
-declaration(s). For example:
+yourself, looking for one or many declarations, using one or two declaration properties.
+For example:
 
 .. code-block:: Python
 

docs/upgrade_issues.rest

@@ -199,7 +199,7 @@ change the default value expression from the script:
 
   #f is "calldef_t" instance
   for arg in f.arguments:
-      arg.default_value = <new default value or None>
+      arg.default_value = <<<new default value or None>>>
 
 
 -------------