[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