New feature: messages with keyword arguments!

[sod] / lib / sod-structs.3

diff --git a/lib/sod-structs.3 b/lib/sod-structs.3
index a6c9db2452375dce0c57cfccb78b8c8f5c39793d..0ef69ca01bdc3dd412aa80599b5c89e4c8f70bff 100644 (file)
--- a/lib/sod-structs.3
+++ b/lib/sod-structs.3
@@ -893,6 +893,27 @@ defined as
 .IB an , 
 .B ...);
 .PP
 .IB an , 
 .B ...);
 .PP

+or a standard message which takes keyword arguments,
+defined as
+.IP
+.I tr
+.IB m ( \c
+.I t1
+.IB a1 ,
+.RB ... ,
+.I tn
+.IB an ?\&
+.IR tn +1
+.IR kn +1
+.RB [ =
+.IR dn +1] \c
+.B ,
+.I tm
+.I km
+.RB [ =
+.IR dm ] \c
+);
+.PP

 two entry points are defined:
 the usual `main' entry point
 which accepts a variable number of
 two entry points are defined:
 the usual `main' entry point
 which accepts a variable number of


@@ -900,7 +921,8 @@ arguments,
 and a `valist' entry point
 which accepts an argument of type
 .B va_list
 and a `valist' entry point
 which accepts an argument of type
 .B va_list

-in place of the variable portion of the argument list.
+in place of the variable portion of the argument list
+or keywords.

 .IP
 .I tr
 .BI (* m )( \c
 .IP
 .I tr
 .BI (* m )( \c


@@ -950,6 +972,7 @@ somewhat less ugly.
 If
 .I m
 takes a variable number of arguments,
 If
 .I m
 takes a variable number of arguments,

+or keyword arguments,

 the macro is more complicated
 and is only available in compilers advertising C99 support,
 but the effect is the same.
 the macro is more complicated
 and is only available in compilers advertising C99 support,
 but the effect is the same.