urllib.urlencode documentation unclear on doseq

[VeXocide]

BPO	8788
Nosy	@orsenthil

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = None
closed_at = <Date 2010-06-02.02:31:50.518>
created_at = <Date 2010-05-22.15:43:00.501>
labels = ['docs']
title = 'urllib.urlencode documentation unclear on doseq'
updated_at = <Date 2010-06-02.02:31:50.417>
user = 'https://bugs.python.org/VeXocide'

bugs.python.org fields:

activity = <Date 2010-06-02.02:31:50.417>
actor = 'orsenthil'
assignee = 'docs@python'
closed = True
closed_date = <Date 2010-06-02.02:31:50.518>
closer = 'orsenthil'
components = ['Documentation']
creation = <Date 2010-05-22.15:43:00.501>
creator = 'VeXocide'
dependencies = []
files = []
hgrepos = []
issue_num = 8788
keywords = []
message_count = 3.0
messages = ['106311', '106312', '106874']
nosy_count = 3.0
nosy_names = ['orsenthil', 'VeXocide', 'docs@python']
pr_nums = []
priority = 'normal'
resolution = 'fixed'
stage = 'resolved'
status = 'closed'
superseder = None
type = None
url = 'https://bugs.python.org/issue8788'
versions = []

[VeXocide]

The urllib.urlencode documentation is unclear with regard to the 'doseq' option. In my opinion it does not clearly state what its functionality is.

[VeXocide]

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.

[orsenthil]

Agree to your concern that doseq parameter is not properly explained.
Fixed in r81645, r81646, r81647 and r81648.