[issue14009] Clearer documentation for cElementTree

Eli Bendersky added the comment: The ET docs have been significantly revamped in 3.3 I don't think cET needs to be documented. It's just confusing. -- resolution: -> wont fix stage: commit review -> committed/rejected status: open -> closed ___ Pyth

[issue14009] Clearer documentation for cElementTree

Changes by Ezio Melotti : -- type: -> enhancement ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.

[issue14009] Clearer documentation for cElementTree

Éric Araujo added the comment: I will commit the patch, keeping the indexing in 3.3 as agreed. I just moved to a new city, so today is paperwork day but in the evening or tomorrow I’ll do Python work :) -- versions: +Python 3.3 ___ Python tracker

[issue14009] Clearer documentation for cElementTree

Eli Bendersky added the comment: Éric, what stops us from closing this issue? Given Ezio and Fred's feedback, I don't object to indexing cET in 3.3 - I guess it can't hurt. -- ___ Python tracker

[issue14009] Clearer documentation for cElementTree

Fred L. Drake, Jr. added the comment: Developers with existing code can reasonably be expected to look it up based on what they're currently importing, so an entry that points to the new recommended practice is good. -- nosy: +fdrake ___ Python track

[issue14009] Clearer documentation for cElementTree

Ezio Melotti added the comment: > Officially, it doesn't exist :) Keep in mind that many users will find about it from the Internet, and it's better to clearly say what it is and that it shouldn't be used anymore than pretending it doesn't exist. (AFAIU this is the current situation, since t

[issue14009] Clearer documentation for cElementTree

Eli Bendersky added the comment: > > If you want to collect additional feedback, you may want to add some > other > > people to the Nosy list :-) > I did not want more feedback, I wanted to leave time for interested > parties to find this bug for themselves and eventually comment :) > > One ques

[issue14009] Clearer documentation for cElementTree

Éric Araujo added the comment: > If you want to collect additional feedback, you may want to add some other > people to the Nosy list :-) I did not want more feedback, I wanted to leave time for interested parties to find this bug for themselves and eventually comment :) One question: when I m

[issue14009] Clearer documentation for cElementTree

Eli Bendersky added the comment: If you want to collect additional feedback, you may want to add some other people to the Nosy list :-) Alternatively, since it's a small doc change you can just commit it and it can be fixed later if someone strongly objects. >>> This: The :class:`Element`

[issue14009] Clearer documentation for cElementTree

Éric Araujo added the comment: +1. Barring other feedback, I will commit your patch. > Also, I must add that I absolutely hate the opening paragraph of the > documentation in this module. This: The :class:`Element` type is a flexible container object, designed to store hierarchical data

[issue14009] Clearer documentation for cElementTree

Eli Bendersky added the comment: Also, I must add that I absolutely hate the opening paragraph of the documentation in this module. Once 14006 is implemented, parts of it should be backported to 2.7 and 3.2 That would be an orthogonal change to what we're discussion here, though --

[issue14009] Clearer documentation for cElementTree

Eli Bendersky added the comment: Éric, indeed it clarifies the usage, but my concern is that it also moves the first mention of the module further down. There's no real reason for someone using CPython 2.7 or 3.2 *not* to use cET. So, some mention should appear in the opening paragraph. I'm a

[issue14009] Clearer documentation for cElementTree

Changes by Éric Araujo : -- keywords: +patch Added file: http://bugs.python.org/file24519/doc-cET.diff ___ Python tracker ___ ___ Pyth

[issue14009] Clearer documentation for cElementTree

New submission from Éric Araujo : This patch should clarify how to use cElementTree usage, as well as improving indexing. -- assignee: docs@python components: Documentation messages: 153338 nosy: docs@python, eli.bendersky, eric.araujo priority: normal severity: normal stage: commit rev