manpage: document and explain __FUNC__ and __NULL__
authorWolfgang Bumiller <wry.git@bumiller.com>
Wed, 24 Apr 2013 15:42:48 +0000 (17:42 +0200)
committerWolfgang Bumiller <wry.git@bumiller.com>
Wed, 24 Apr 2013 15:42:48 +0000 (17:42 +0200)
doc/gmqcc.1

index da79a5bd0415b15165c7b3e4f09d708a38478ecf..56728d17588c4f432180f7bd1769faa784d160ec 100644 (file)
@@ -351,15 +351,28 @@ __RANDOM__
 __RANDOM_LAST__
 __DATE__
 __TIME__
+__FUNC__
 .Ed
 .Pp
+Note that
+.Li __FUNC__
+is not actually a preprocessor macro, but is recognized by the parser
+even with the preprocessor disabled.
+.Pp
 Note that fteqcc also defines
 .Li __NULL__
-which is not implemented yet.
+which becomes the first global. Assigning it to a vector does not
+yield the same result as in gmqcc where
+.Li __NULL__
+is defined to
+.Li nil
 (See
 .Fl f Ns Cm untyped-nil
-about gmqcc's alternative to
-.Li __NULL__ Ns ).
+), which will cause the vector to be zero in all components. With fteqcc
+only the first component will be 0, while the other two will become
+the first to of the global return value. This behavior is odd and
+relying on it should be discouraged, and thus is not supported by
+gmqcc.
 .It Fl f Ns Cm relaxed-switch
 Allow switch cases to use non constant variables.
 .It Fl f Ns Cm short-logic