Issue #2343 : Option to prepopulate a placeholder
add some missing doc
suppress unused variable
correct the Sphinx ref error...
"value" key become "values" for best consistency between name and content
Merge pull request #2505 from DylannCordel/issue2343

Issue #2343 : Option to prepopulate a placeholder