clarify trailing comma in function argument list
(SF bug #798652)
diff --git a/Doc/ref/ref5.tex b/Doc/ref/ref5.tex
index c7e5fd7..036533c 100644
--- a/Doc/ref/ref5.tex
+++ b/Doc/ref/ref5.tex
@@ -493,8 +493,8 @@
{\token{identifier} "=" \token{expression}}
\end{productionlist}
-A trailing comma may be present after an argument list but does not
-affect the semantics.
+A trailing comma may be present after the positional and keyword
+arguments but does not affect the semantics.
The primary must evaluate to a callable object (user-defined
functions, built-in functions, methods of built-in objects, class
diff --git a/Doc/ref/ref7.tex b/Doc/ref/ref7.tex
index 88c548c..92ee655 100644
--- a/Doc/ref/ref7.tex
+++ b/Doc/ref/ref7.tex
@@ -322,10 +322,10 @@
\production{decorator}
{"@" \token{dotted_name} ["(" [\token{argument_list} [","]] ")"] NEWLINE}
\production{parameter_list}
- {(\token{defparameter} ",")*}
- \productioncont{("*" \token{identifier} [, "**" \token{identifier}]}
- \productioncont{| "**" \token{identifier}
- | \token{defparameter} [","])}
+ {(\token{defparameter} ",")*}
+ \productioncont{(~~"*" \token{identifier} [, "**" \token{identifier}]}
+ \productioncont{ | "**" \token{identifier}}
+ \productioncont{ | \token{defparameter} [","] )}
\production{defparameter}
{\token{parameter} ["=" \token{expression}]}
\production{sublist}