* [gentoo-commits] proj/devmanual:master commit in: xsl/, ebuild-writing/functions/src_configure/, ...
@ 2013-05-04 8:54 Markos Chandras
0 siblings, 0 replies; only message in thread
From: Markos Chandras @ 2013-05-04 8:54 UTC (permalink / raw
To: gentoo-commits
commit: 83dd05f0453984bdb6e78365ff13bdbf5894c3e5
Author: W. Trevor King <wking <AT> tremily <DOT> us>
AuthorDate: Sat Mar 9 13:04:22 2013 +0000
Commit: Markos Chandras <hwoarang <AT> gentoo <DOT> org>
CommitDate: Sat May 4 08:53:29 2013 +0000
URL: http://git.overlays.gentoo.org/gitweb/?p=proj/devmanual.git;a=commit;h=83dd05f0
Remove distutils section
This section hasn't been touched since 2006, and is a bit stale. For
example, the TK-use-flags section has been out of date since EAPI 2
and 2-style USE dependencies.
See https://bugs.gentoo.org/show_bug.cgi?id=460686
---
appendices/contributors/text.xml | 1 -
.../functions/src_compile/distutils/text.xml | 85 --------------------
ebuild-writing/functions/src_compile/text.xml | 1 -
ebuild-writing/functions/src_configure/text.xml | 1 -
xsl/lang.highlight.ebuild.xsl | 6 --
5 files changed, 0 insertions(+), 94 deletions(-)
diff --git a/appendices/contributors/text.xml b/appendices/contributors/text.xml
index ee6d96c..80553b5 100644
--- a/appendices/contributors/text.xml
+++ b/appendices/contributors/text.xml
@@ -14,7 +14,6 @@ This page lists the contributions to the Gentoo Development Guide:
</author>
<author name="Grant Goodyear" email="g2boojum@gentoo.org">
<uri link="::tools-reference/cat/#Here Documents"/>,
- <uri link="::ebuild-writing/functions/src_compile/distutils"/>
</author>
<author name="Aaron Walker" email="ka0ttic@gentoo.org">
<uri link="::tasks-reference/completion"/>,
diff --git a/ebuild-writing/functions/src_compile/distutils/text.xml b/ebuild-writing/functions/src_compile/distutils/text.xml
deleted file mode 100644
index bf9157c..0000000
--- a/ebuild-writing/functions/src_compile/distutils/text.xml
+++ /dev/null
@@ -1,85 +0,0 @@
-<?xml version="1.0"?>
-<guide self="ebuild-writing/functions/src_compile/distutils/">
-<chapter>
-<title>Distutils</title>
-
-<section>
-<title>General overview</title>
-
-<body>
-<p>
-The Python packaging system is known as "distutils", and the hallmark
-of a Python package using distutils is the presence of a <c>setup.py</c>
-file. (One can think of the <c>setup.py</c> file as the Python equivalent of
-a Makefile.) Although distutils is straightforward to use by directly
-running the <c>setup.py</c> with the appropriate arguments, the distutils
-eclass makes the process much simpler (and dramatically lowers the
-chance of sandbox violations). For example, for the <c>dev-python/id3-py</c>
-package the body of the ebuild (other than the header and URIs) could
-have been written as just:
-</p>
-
-<codesample lang="ebuild">
-inherit distutils
-
-DOCS="CHANGES"
-</codesample>
-
-<p>
-Any files listed in <c>${DOCS}</c> will be put in the docs directory when
-installed. Note that older versions of the distutils eclass used
-<c>${mydoc}</c> instead, but the preferred variable is <c>DOCS</c>.
-</p>
-
-<p>
-In practice, some tweaking is often required in
-the <c>src_compile()</c> or, more commonly, in
-the <c>src_install()</c> steps, and the distutils eclass provides
-the <c>distutils_src_compile()</c> and
-the <c>distutils_src_install()</c> convenience functions:
-</p>
-
-<codesample lang="ebuild">
-src_compile() {
- distutils_src_compile
- # ...
-}
-
-src_install() {
- # From the docutils ebuild
- distutils_src_install
- cd "${S}/tools"
- for tool in *.py; do
- newbin ${tool} docutils-${tool}
- done
-
- # ...
-}
-</codesample>
-
-</body>
-</section>
-
-<section>
-<title>Tkinter (Tk) support</title>
-<body>
-
-<p>
-Until Portage gains the long-requested ability to depend on <c>USE</c>
-flags, ebuild authors who package graphical Python programs will
-probably need to check at emerge-time whether or not Python was
-compiled with support for Tkinter. Since Tkinter requires Tk, which
-requires X, default Python builds do not include Tkinter. It's easy
-enough to check:
-</p>
-
-<codesample lang="ebuild">
-pkg_setup() {
- distutils_python_tkinter
-}
-</codesample>
-
-</body>
-</section>
-</chapter>
-</guide>
diff --git a/ebuild-writing/functions/src_compile/text.xml b/ebuild-writing/functions/src_compile/text.xml
index 0c86ba8..89350cb 100644
--- a/ebuild-writing/functions/src_compile/text.xml
+++ b/ebuild-writing/functions/src_compile/text.xml
@@ -114,6 +114,5 @@ The following subsections cover different topics which often occur when writing
<include href="build-environment/"/>
<!--<include href="configuring/"/>-->
<include href="building/"/>
-<include href="distutils/"/>
<include href="no-build-system/"/>
</guide>
diff --git a/ebuild-writing/functions/src_configure/text.xml b/ebuild-writing/functions/src_configure/text.xml
index 9eeedd6..0740309 100644
--- a/ebuild-writing/functions/src_configure/text.xml
+++ b/ebuild-writing/functions/src_configure/text.xml
@@ -78,7 +78,6 @@ The following subsections cover different topics which often occur when writing
<include href="configuring/"/>
<!--<include href="build-environment/"/>
<include href="building/"/>
-<include href="distutils/"/>
<include href="no-build-system/"/>-->
</guide>
diff --git a/xsl/lang.highlight.ebuild.xsl b/xsl/lang.highlight.ebuild.xsl
index 2b6b124..4f84b8d 100644
--- a/xsl/lang.highlight.ebuild.xsl
+++ b/xsl/lang.highlight.ebuild.xsl
@@ -299,12 +299,6 @@
<span class="Statement"><xsl:value-of select="$data"/></span>
</xsl:when>
- <!-- distutils -->
- <xsl:when test="$data = 'distutils_src_compile' or $data = 'distutils_src_install' or $data = 'distutils_pkg_postrm' or
- $data = 'distutils_pkg_postinst' or $data = 'distutils_python_version' or $data = 'disutils_python_tkinter'">
- <span class="Statement"><xsl:value-of select="$data"/></span>
- </xsl:when>
-
<!-- depend$dataapache -->
<xsl:when test="$data = 'need_apache' or $data = 'need_apache1' or $data = 'need_apache2'">
<span class="Statement"><xsl:value-of select="$data"/></span>
^ permalink raw reply related [flat|nested] only message in thread
only message in thread, other threads:[~2013-05-04 8:54 UTC | newest]
Thread overview: (only message) (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2013-05-04 8:54 [gentoo-commits] proj/devmanual:master commit in: xsl/, ebuild-writing/functions/src_configure/, Markos Chandras
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox