[issue8788] urllib.urlencode documentation unclear on doseq

New submission from Jeroen Habraken vexocide@gmail.com:
The urllib.urlencode documentation is unclear with regard to the 'doseq' option. In my opinion it does not clearly state what its functionality is.
---------- assignee: docs@python components: Documentation messages: 106311 nosy: VeXocide, docs@python priority: normal severity: normal status: open title: urllib.urlencode documentation unclear on doseq
_______________________________________ Python tracker report@bugs.python.org http://bugs.python.org/issue8788 _______________________________________

Jeroen Habraken vexocide@gmail.com added the comment:
An elaboration as requested on IRC: It appears to make claims about 'the sequence', but doesn't make clear that 'doseq' matters when *v* is a sequence. It is easy to assume it refers to the query sequence, which is of course always a sequence.
----------
_______________________________________ Python tracker report@bugs.python.org http://bugs.python.org/issue8788 _______________________________________

Senthil Kumaran orsenthil@gmail.com added the comment:
Agree to your concern that doseq parameter is not properly explained. Fixed in r81645, r81646, r81647 and r81648.
---------- nosy: +orsenthil resolution: -> fixed stage: -> committed/rejected status: open -> closed
_______________________________________ Python tracker report@bugs.python.org http://bugs.python.org/issue8788 _______________________________________
participants (2)
-
Jeroen Habraken
-
Senthil Kumaran