Add note about old-style function declarations to the manual.

diff --git a/doc/man/libcdecl.3 b/doc/man/libcdecl.3
index 8bcc39440e18379056c4bd2cdd3f726a190dfe89..a4dc5f45581fe9b85b7226411c5e9240dfd0f1a4 100644 (file)
--- a/doc/man/libcdecl.3
+++ b/doc/man/libcdecl.3
@@ -257,6 +257,13 @@ each function parameter has exactly one full declarator (abstract or
 otherwise).   If
 .Va variadic
 is true, then the function is variadic.
+.Pp
+Note that old-style function declarations with non-empty identifier lists are
+not directly represented here: this is because they are syntactically identical
+to a prototype where every parameter is a typedef name.  Since
+.Nm
+isn't a C compiler, there is no way for the parser to tell these two kinds of
+declarations apart.
 .Sh ERROR HANDLING
 Some functions in
 .Nm