docs(man): write about the incompatibility about --excmd=mixed option

Close #3557.

Signed-off-by: Masatake YAMATO <[email protected]>

Author: masatake

docs/man/ctags-incompatibilities.7.rst

@@ -34,6 +34,11 @@ Environment variables for arranging command lines
 Universal Ctags doesn't read ``CTAGS`` and/or ``ETAGS`` environment
 variables.
 
+Behavior when ``--excmd=mixed`` is given
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Exuberant Ctags uses line numbers as addresses for C preprocessor
+macro definition tags. Universal Ctags uses patterns for the tags.
+
 Incompatibilities in command line interface
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

docs/man/ctags.1.rst

@@ -563,12 +563,16 @@ See "`TAG ENTRIES`_" about fields, kinds, roles, and extras.
 		removed since the tag file was generated.
 
 	``mixed``
-		In this mode, patterns are generally used with a few exceptions.
-		For C, line numbers are used for macro definition tags. For Fortran, line numbers
+		In this mode, patterns are generally used with an exceptions.
+		For Fortran, line numbers
 		are used for common blocks because their corresponding source lines
 		are generally identical, making pattern searches useless
 		for finding all matches.
 
+		Exuberant Ctags has one more exception; for C, line numbers are used
+		for macro definition tags. Universal Ctags doesn't have this exception
+		for C.
+
 		This was the default format generated by the original ctags and is,
 		therefore, retained as the default for this option.
 

man/ctags-incompatibilities.7.rst.in

@@ -34,6 +34,11 @@ Environment variables for arranging command lines
 Universal Ctags doesn't read ``CTAGS`` and/or ``ETAGS`` environment
 variables.
 
+Behavior when ``--excmd=mixed`` is given
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Exuberant Ctags uses line numbers as addresses for C preprocessor
+macro definition tags. Universal Ctags uses patterns for the tags.
+
 Incompatibilities in command line interface
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

man/ctags.1.rst.in

@@ -563,12 +563,16 @@ See "`TAG ENTRIES`_" about fields, kinds, roles, and extras.
 		removed since the tag file was generated.
 
 	``mixed``
-		In this mode, patterns are generally used with a few exceptions.
-		For C, line numbers are used for macro definition tags. For Fortran, line numbers
+		In this mode, patterns are generally used with an exceptions.
+		For Fortran, line numbers
 		are used for common blocks because their corresponding source lines
 		are generally identical, making pattern searches useless
 		for finding all matches.
 
+		Exuberant Ctags has one more exception; for C, line numbers are used
+		for macro definition tags. Universal Ctags doesn't have this exception
+		for C.
+
 		This was the default format generated by the original ctags and is,
 		therefore, retained as the default for this option.