Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 460686 - devmanual distutils section outdated
Summary: devmanual distutils section outdated
Status: RESOLVED FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Devmanual (show other bugs)
Hardware: All Linux
: Normal minor (vote)
Assignee: Python Gentoo Team
URL:
Whiteboard:
Keywords: PATCH, REVIEWED
Depends on:
Blocks:
 
Reported: 2013-03-07 13:45 UTC by W. Trevor King
Modified: 2013-05-04 08:54 UTC (History)
1 user (show)

See Also:
Package list:
Runtime testing required: ---

Attachments
Removing the distutils section (0001-Remove-distutils-section.patch,5.83 KB, text/plain)
2013-03-09 13:08 UTC, W. Trevor King 		Details
View All Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description W. Trevor King 2013-03-07 13:45:28 UTC 
This section [1] hasn't been touched since 2006, and it should probably be replaced by a link to the Python developer's guide [2].  For example, the TK-use-flags section has been out of date since EAPI 2 and 2-style USE dependencies.

[1]: http://devmanual.gentoo.org/ebuild-writing/functions/src_compile/distutils/
[1]: http://www.gentoo.org/proj/en/Python/developersguide.xml

Reproducible: Always
Comment 1 Markos Chandras (RETIRED) gentoo-dev 2013-03-07 13:47:25 UTC 
Reassigning to python@
Comment 2 Michał Górny archtester Gentoo Infrastructure gentoo-dev Security 2013-03-09 12:45:54 UTC 
Hmm… maybe we should just drop the section? It feels at least a bit wrong to describe distutils -- which basically occupies all the phases -- in src_compile section.
Comment 3 W. Trevor King 2013-03-09 13:08:47 UTC 
Created attachment 341430 [details]
Removing the distutils section

This gets rid of everything that `git grep distutils` turns up.  I'm not sure where to link in the Python developer's guide.  Maybe there should be a table of eclasses with brief descriptions of each one.  Then the Python eclasses could link to the Python developer's guide.
Comment 4 Markos Chandras (RETIRED) gentoo-dev 2013-05-03 19:22:57 UTC 
(In reply to comment #3)
> Created attachment 341430 [details]
> Removing the distutils section
> 
> This gets rid of everything that `git grep distutils` turns up.  I'm not
> sure where to link in the Python developer's guide.  Maybe there should be a
> table of eclasses with brief descriptions of each one.  Then the Python
> eclasses could link to the Python developer's guide.

Devmanual has a link to all eclasses when it being regenerated[1].

http://devmanual.gentoo.org/eclass-reference/index.html
Comment 5 Markos Chandras (RETIRED) gentoo-dev 2013-05-03 19:23:58 UTC 
fwiw the patch looks good to me. I will review it again before I commit it