pgfpointpolar bug / documentation bug?

Question

In the current pgmanual, at page 976, section 96.2, you can find this:

...and as you can see, even the example in the manual is showing that the command is not working. I checked that:

\documentclass[border=10pt]{standalone}
\usepackage{tikz}
\begin{document}
\begin{tikzpicture}
    \draw[help lines] (0,0) grid (3,2);
    \foreach \angle in {0,10,...,90}
    {\pgfpathcircle{\pgfpointpolar{\angle}{1cm and 2cm}}{2pt}}
    \pgfusepath{fill}
\end{tikzpicture}
\end{document}

do indeed work:

Can I safely use the and syntax in my code? I suppose this is a bug in the manual, maybe remnant of an old way of expressing elliptical axis; I think that the ...and... syntax is the modern one. Am I correct?

Answer 1

The snippets in the question are from the TikZ/PGF manual for version 3.0.1a. The manual for version 3.1.2 (on CTAN since April 6, 2019) contains the code in Section 101.2 (page 1059). The code is identical except for the use of and instead of /, as shown in the question.

Note that the new manual is still a bit confusing and inconsistent. The command entry is \pgfpointpolar{<degree>}{<radius>/<y-radius>}, as in the older manual, which does not correspond to the code snippet, whereas for the related command \pgfpatharc (Section 102.6, page 1071) the entry is given as \pgfpatharc{<start angle>}{<end angle>}{<radius>and<y-radius>} with a snippet that uses and. But the snippets work, and and can be used safely.