From: Nick Bowler <nbowler@draconx.ca>
Date: Wed, 30 Nov 2011 01:35:05 +0000 (-0500)
Subject: Add note about old-style function declarations to the manual.
X-Git-Tag: v1~74
X-Git-Url: https://git.draconx.ca/gitweb/cdecl99.git/commitdiff_plain/c0b4acddf86a9dd0a7d8d8f8cc096cfec771bca7

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

diff --git a/doc/man/libcdecl.3 b/doc/man/libcdecl.3
index 8bcc394..a4dc5f4 100644
--- 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