Mailman 3 - docs - python.org

[issue1495229] W3C <-> Python DOM type mapping docs need updating
by Terry J. Reedy 25 Jul '10

25 Jul '10

Terry J. Reedy <tjreedy(a)udel.edu> added the comment: Unlike with some issues, my in-message recommendations here do not constitute a patch. docs@python could update the link immediately. I would be willing to review the more extensive patch for 3.x if someone makes one. ---------- keywords: +easy stage: -> needs patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue1495229> _______________________________________

1 0

[issue7637] Improve 19.5. xml.dom.minidom doc
by Mark Lawrence 25 Jul '10

25 Jul '10

Mark Lawrence <breamoreboy(a)yahoo.co.uk> added the comment: Items 1) and 3) have been committed, only 2) needs to be addressed. ---------- assignee: georg.brandl -> docs@python nosy: +BreamoreBoy, docs@python _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue7637> _______________________________________

1 0

[issue1495229] W3C <-> Python DOM type mapping docs need updating
by Mark Lawrence 25 Jul '10

25 Jul '10

Mark Lawrence <breamoreboy(a)yahoo.co.uk> added the comment: Nobody has objected to Terry Reedy's recommendations so can the docs be updated please. ---------- assignee: loewis -> docs@python nosy: +BreamoreBoy, docs@python _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue1495229> _______________________________________

1 0

[issue2864] etree: Add XPath documentation
by Mark Lawrence 25 Jul '10

25 Jul '10

Changes by Mark Lawrence <breamoreboy(a)yahoo.co.uk>: ---------- assignee: effbot -> docs@python nosy: -effbot _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue2864> _______________________________________

1 0

[issue7635] 19.6 xml.dom.pulldom doc: stub?
by Mark Smith 25 Jul '10

25 Jul '10

Changes by Mark Smith <mark.smith(a)practicalpoetry.co.uk>: Removed file: http://bugs.python.org/file18179/7635.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue7635> _______________________________________

1 0

[issue7635] 19.6 xml.dom.pulldom doc: stub?
by Mark Smith 25 Jul '10

25 Jul '10

Mark Smith <mark.smith(a)practicalpoetry.co.uk> added the comment: Terry, thanks for the feedback! I have added a patch, replacing the previous one, which deals with your points 1 and 3 in the following ways: 1. I have used (an edited form of) your synopsis - I've removed the details of exactly what is returned from the iterator, as I thought it made the sentence structure slightly awkward - hope you don't mind. I've moved the old synopsis to the heading, which is where I intended it to be anyway. 3. I added the newline - I don't think this is really a problem, but neither is the fix :) Regarding point 2: I agree with you - I struggled with whether to include references to these classes, eventually settling for what you see. I suppose they could be re-used for converting SAX events to DOM nodes, so it could be useful to know they are there. SAX2DOM isn't even used internally, so is technically part of the module's public interface, but with such brittle behaviour that I think it should really be removed. It automatically adds children to their parent when they are parsed -- but the children will only be parsed if the buffer is large enough. If it isn't then you can get incorrectly empty or even partial subtrees. ---------- Added file: http://bugs.python.org/file18194/7635_2.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue7635> _______________________________________

1 0

[issue2204] document ConfigParser behaviour when a file has same section multiple times
by Mark Lawrence 25 Jul '10

25 Jul '10

Mark Lawrence <breamoreboy(a)yahoo.co.uk> added the comment: @Łukasz: could you provide a patch that clarifies the default behaviour. ---------- assignee: georg.brandl -> docs@python nosy: +BreamoreBoy, docs@python stage: unit test needed -> needs patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue2204> _______________________________________

1 0

[issue8888] Promote SafeConfigParser and warn about ConfigParser
by Éric Araujo 25 Jul '10

25 Jul '10

New submission from Éric Araujo <merwok(a)netwok.org>: Problems like #8880 could be prevented with a deprecation notice for the ConfigParser class, in favor of SafeConfigParser. (Not sure if R. David Murray meant just a recommendation or a real deprecation.) ---------- assignee: docs@python components: Documentation messages: 106943 nosy: docs@python, merwok, r.david.murray priority: normal severity: normal status: open title: Promote SafeConfigParser and warn about ConfigParser versions: Python 2.6, Python 2.7, Python 3.1, Python 3.2 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8888> _______________________________________

3 2

[issue7303] pkgutil lacks documentation for useful functions
by Mark Lawrence 25 Jul '10

25 Jul '10

Changes by Mark Lawrence <breamoreboy(a)yahoo.co.uk>: ---------- stage: needs patch -> patch review _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue7303> _______________________________________

1 0

[issue7303] pkgutil lacks documentation for useful functions
by Grant Limberg 24 Jul '10

24 Jul '10

Grant Limberg <glimberg(a)gmail.com> added the comment: I've taken the liberty of creating a patch for this issue. I've taken the docstrings fromt he pkgutil module and conveted them to reST. Please let me know if there are any changes necessary. ---------- keywords: +patch nosy: +Grant.Limberg Added file: http://bugs.python.org/file18193/pkgutil-docs-py3k-branch.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue7303> _______________________________________

1 0