This issue tracker has been migrated to GitHub ,
and is currently read-only.
For more information,
see the GitHub FAQs in the Python's Developer Guide.
Created on 2012年01月05日 19:02 by flox, last changed 2022年04月11日 14:57 by admin. This issue is now closed.
| Messages (9) | |||
|---|---|---|---|
| msg150683 - (view) | Author: Florent Xicluna (flox) * (Python committer) | Date: 2012年01月05日 19:02 | |
http://docs.python.org/distutils/apiref.html?highlight=XXX#module-distutils.ccompiler We find lots of "XXX" and "XXX see also." which give no information. |
|||
| msg150745 - (view) | Author: Éric Araujo (eric.araujo) * (Python committer) | Date: 2012年01月06日 16:54 | |
Tarek ruled that time spent improving the distutils docs was time lost and better spent on distutils2. Accordingly, I only fix clear bugs in the doc but don’t improve them in any way. I’m inclined to close this as wontfix, or I can remove the XXX if you’re strongly against them. (For the packaging docs, I will fix them properly.) |
|||
| msg150793 - (view) | Author: Georg Brandl (georg.brandl) * (Python committer) | Date: 2012年01月07日 12:57 | |
I would make comments out of the XXX, and if a whole section is just that XXX, remove the section as well. |
|||
| msg150798 - (view) | Author: Éric Araujo (eric.araujo) * (Python committer) | Date: 2012年01月07日 14:47 | |
These are the XXX: XXX true? does ANSI say anything about this? XXX defaults to what? XXX see also. XXX see also. XXX see also. XXX see also. XXX see also. The first two are questions that can be answered, and when I research them for the packaging docs I could also backport the changes to the distutils docs; what to do for the other instances is less clear, so just deleting may be better than turning them into comments that will never get solved. |
|||
| msg150800 - (view) | Author: Georg Brandl (georg.brandl) * (Python committer) | Date: 2012年01月07日 14:51 | |
Agreed. |
|||
| msg150801 - (view) | Author: Florent Xicluna (flox) * (Python committer) | Date: 2012年01月07日 15:06 | |
The proposed solution is ok. It sounds like unfinished documentation when you hit an "XXX". For the "/dev/" documentation, it's OK, but for the released version, we should avoid it. |
|||
| msg152686 - (view) | Author: Roundup Robot (python-dev) (Python triager) | Date: 2012年02月05日 12:50 | |
New changeset 3d25869fce0c by Éric Araujo in branch '3.2': Hide or remove user-visible XXX notes from distutils doc (#13716). http://hg.python.org/cpython/rev/3d25869fce0c New changeset 1cb9b8126534 by Éric Araujo in branch 'default': Merge edits from 3.2 (#13716, #1040439, #2945, #13770, #6715) http://hg.python.org/cpython/rev/1cb9b8126534 |
|||
| msg154299 - (view) | Author: Roundup Robot (python-dev) (Python triager) | Date: 2012年02月26日 02:49 | |
New changeset e853ea9efc6e by Éric Araujo in branch '2.7': Hide or remove user-visible XXX notes from distutils doc (#13716). http://hg.python.org/cpython/rev/e853ea9efc6e |
|||
| msg154307 - (view) | Author: Éric Araujo (eric.araujo) * (Python committer) | Date: 2012年02月26日 03:21 | |
Done. |
|||
| History | |||
|---|---|---|---|
| Date | User | Action | Args |
| 2022年04月11日 14:57:25 | admin | set | github: 57925 |
| 2012年02月26日 03:21:50 | eric.araujo | set | status: open -> closed type: behavior -> enhancement messages: + msg154307 resolution: fixed stage: needs patch -> resolved |
| 2012年02月26日 02:49:09 | python-dev | set | messages: + msg154299 |
| 2012年02月05日 12:50:14 | python-dev | set | nosy:
+ python-dev messages: + msg152686 |
| 2012年01月07日 15:06:49 | flox | set | messages: + msg150801 |
| 2012年01月07日 14:51:36 | georg.brandl | set | messages: + msg150800 |
| 2012年01月07日 14:47:05 | eric.araujo | set | assignee: docs@python -> eric.araujo messages: + msg150798 |
| 2012年01月07日 12:57:39 | georg.brandl | set | nosy:
+ georg.brandl messages: + msg150793 |
| 2012年01月06日 16:54:12 | eric.araujo | set | messages: + msg150745 |
| 2012年01月05日 19:04:00 | flox | set | nosy:
+ tarek, eric.araujo versions: + Python 3.2, Python 3.3 |
| 2012年01月05日 19:02:15 | flox | create | |