[doc] update the parameter list

Closes #1236

See merge request !3492

(cherry picked from commit c680ca8d)

4bd19c01 [doc] update the parameter list
eab2a9d1 [bin/doc] deprecate some parameters