Foreach operation's syntax is incorrectly documented

[Symbol1]

Version: 3.1.9a

On page 167, the document reads

\path ... foreach⟨variables⟩[⟨options⟩] in {⟨path commands⟩} ...;

which suggest that the syntax is
\path (0,0) foreach \x in { -- (\x, \x^2) };
while in reality you have to specify a list
\path (0,0) foreach \x in {1, 2, 3, 4, 5} { -- (\x, \x^2) };

For comparison, foreach statement's syntax is documented on page 1001 as follows

\foreach ⟨variables⟩ [⟨options⟩] in ⟨list⟩ ⟨commands⟩

which brings up a question:
Isn't ⟨list⟩ always enclosed by curly braces?
So we should have \marg{list} in both tikz-paths.tex#L1123 and pgffor.tex#L23.

(I am not pull-requesting this because I don't know what should I use.
\marg{list} or \meta{list}?)

[muzimuzhi]

I think \meta{list} is enough, in which

pgf/doc/generic/pgf/text-en/pgfmanual-en-pgffor.tex

Lines 35 to 38 in 9ab9df7

	Again, in the easiest case, \meta{list} is either a comma-separated list of
	values surrounded by curly braces or it is the name of a macro that contain
	such a list of values. Anything can be used as a value, but numbers are
	most likely.