New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
distutils doc contains lots of XXX #57925
Comments
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. |
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.) |
I would make comments out of the XXX, and if a whole section is just that XXX, remove the section as well. |
These are the XXX: XXX true? does ANSI say anything about this? 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. |
Agreed. |
The proposed solution is ok. It sounds like unfinished documentation when you hit an "XXX". |
New changeset 3d25869fce0c by Éric Araujo in branch '3.2': New changeset 1cb9b8126534 by Éric Araujo in branch 'default': |
New changeset e853ea9efc6e by Éric Araujo in branch '2.7': |
Done. |
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:
bugs.python.org fields:
The text was updated successfully, but these errors were encountered: