Mailman 3 July 2010 - docs

[issue7447] Sum() doc and behavior mismatch
by Terry J. Reedy 28 Jul '10

28 Jul '10

Terry J. Reedy <tjreedy(a)udel.edu> added the comment: I am puzzled that the fake name 'itertools.itertools.chain.from_iterable' works better than the real name 'itertools.chain.from_iterable'. Some bug in the tool chain? ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue7447> _______________________________________

1 0

Tutorial Chapter 5
by LILI Luo 28 Jul '10

28 Jul '10

To whom it may concern: The following sample script doesn't work. To loop over two or more sequences at the same time, the entries can be paired with the zip() function. >>> questions = ['name', 'quest', 'favorite color'] >>> answers = ['lancelot', 'the holy grail', 'blue'] >>> for q, a in zip(questions, answers): ... print 'What is your {0}? It is {1}.'.format(q, a) ... What is your name? It is lancelot. What is your quest? It is the holy grail. What is your favorite color? It is blue. --crocodile _________________________________________________________________ Hotmail: Trusted email with powerful SPAM protection. https://signup.live.com/signup.aspx?id=60969

1 0

Cannot 'Quick search' 2.6.5 docs
by Benjamin Rutt 28 Jul '10

28 Jul '10

I can search the latest docs: * http://docs.python.org/search.html?q=divmod&check_keywords=yes&area=default*<http://docs.python.org/search.html?q=divmod&check_keywords=yes&area=default> But not the 2.6.5 docs: * http://docs.python.org/release/2.6.5/search.html?q=divmod&check_keywords=ye… *<http://docs.python.org/release/2.6.5/search.html?q=divmod&check_keywords=ye…> (In the latter, I get no results, but I'm pretty sure 'divmod' was in 2.6.5 so I would expect results). Pretty sure this falls under a doc bug. Thanks!

1 0

[issue7447] Sum() doc and behavior mismatch
by Ezio Melotti 28 Jul '10

28 Jul '10

Ezio Melotti <ezio.melotti(a)gmail.com> added the comment: You could also use start=0 in the signature. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue7447> _______________________________________

1 0

[issue7447] Sum() doc and behavior mismatch
by Leonhard Vogt 28 Jul '10

28 Jul '10

Leonhard Vogt <leonhard.vogt(a)gmx.ch> added the comment: another patch: - moved string case to first position, i think it's the most important. - reworded (shortened) list case. - wrapped for <80 caracter lines. still using itertools.itertools.chain.from_iterable as mentioned in previous message. I missed georgs use of ~ in the link, but i think its clearer to mention the full name of the function anyway. ---------- Added file: http://bugs.python.org/file18223/functions.rst.patch4.txt _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue7447> _______________________________________

1 0

[issue3874] documentation bug: HTMLParser needs to document unknown_decl
by Terry J. Reedy 27 Jul '10

27 Jul '10

Terry J. Reedy <tjreedy(a)udel.edu> added the comment: OK, your recommendation is to add one entry with the text suggested in the message. Given the name, the text seems reasonable. I will leave it to a doc person to format and apply. ---------- keywords: +patch stage: -> needs patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue3874> _______________________________________

1 0

[issue3874] documentation bug: HTMLParser needs to document unknown_decl
by Terry J. Reedy 27 Jul '10

27 Jul '10

Terry J. Reedy <tjreedy(a)udel.edu> added the comment: I understand that getting no response to a submission is not pleasant. I do not like it either. That is partly why I have started reviewing old issues. In the past couple of weeks, I have gotten old two orphaned patches applied by updating the headers, reading the patch, and adding a first-response approval message that got the attention of someone with code-commit privileges. I hope you agree that late is better than never. I just discovered the nosy-count box on the search page. 351 open issues with a nosy count of 1 (which means no response unless someone responded and then removed themself) is too many. We need more issue reviewers. As to your message: this is *our* tracker, not my tracker. My participation is as much voluntary as yours. I hope you do not really give up on improving Python and its documentation. I did not expect that you *should* have known submission details. That is why I tried to inform you. In particular, when an issue is marked as 'documentation', it is automatically assigned to 'docs@python', a pseudo-user standing in for people who handle doc revisions. Now they will see this issue, whereas they would not have before. Please excuse me for not remembering the title as I responded to the message. It is best if message text stands alone. Again, I hope you would agree that an somewhat ignorant response may be better than none. In order for the doc maintainers to add an entry, someone knowledgeable must write it. Your paragraph of explanation is a start, but more editing is needed. Looking at dir(html.parser.HTMLParser) and help(...), I see that there are several public internal methods. Some have doc strings that show up with help(), some do not. I thing all should. Some are defined on HTMLParser and some inherited from the undocumented (I believe) _markupbase.ParserBase. I see that there are also several (completely undocumented except fir dir()) private ('_xyz') internal methods. This implies to me that the public internal methods were made public rather than private because there might be reason to override them. If so, perhaps there should be a new subsection on public internal methods to explain what is what with them. What do you think? Document just one, some, or all? ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue3874> _______________________________________

2 1

Hi, I've got problem to access python2.6.2's doc, is it possible that you could send me a copy in HTML format
by GAO Chenxi 27 Jul '10

27 Jul '10

I'm a python beginner, due to the network problem i can't get access python 2.6.2's doc, i'll be appreciate if i could get the tar.gz doc in HTML format, thx ) -- Regards, GAO Chenxi Hebei University of Technology, Computer Science and Software Engineering Department 0086 13520920190

1 0

[issue7447] Sum() doc and behavior mismatch
by Leonhard Vogt 26 Jul '10

26 Jul '10

Leonhard Vogt <leonhard.vogt(a)gmx.ch> added the comment: Thank you. I think the specific list of list example is better for the sum documentation because lists support the + operator. I don't think that someone would consider using sum for chaining arbitrary iterables. What about a concise "To concatenate lists use itertools.chain.from_iterable." and letting the "apply list constructor" part as an exercise to the reader? I did the explicit reference to itertools.itertools.chain.from_iterable since the default or the explicit link to itertools.chain.from_iterable did not produce a correct link in the html docs. I applied patch3 and ran make html; there is no html link to from_iterable produced. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue7447> _______________________________________

1 0

[issue9376] Refer to gnuwin32 diff util on development FAQ
by Mark Lawrence 26 Jul '10

26 Jul '10

New submission from Mark Lawrence <breamoreboy(a)yahoo.co.uk>: Section 6.1 How to make a patch? currently reads in part (a Windows version is available as part of the cygwin tools). I suggest that this is reworded to read (Windows versions are available as part of the cygwin tools or as part of the gnuwin32 project) I simply find it much easier to download and install these individual tools, e.g. I also have their version of grep which is vastly superior to Windows find ---------- assignee: docs@python components: Documentation keywords: easy messages: 111536 nosy: BreamoreBoy, docs@python priority: normal severity: normal status: open title: Refer to gnuwin32 diff util on development FAQ type: feature request _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9376> _______________________________________

4 8