The devmanual repository has been moved to a new location, please read the MOVED... master
authorChristian Ruppert <idl0r@gentoo.org>
Sun, 2 Jan 2011 02:29:47 +0000 (03:29 +0100)
committerChristian Ruppert <idl0r@gentoo.org>
Sun, 2 Jan 2011 02:29:47 +0000 (03:29 +0100)
157 files changed:
MOVED [new file with mode: 0644]
Makefile [deleted file]
appendices/common-problems/text.xml [deleted file]
appendices/contributing/text.xml [deleted file]
appendices/contributors/text.xml [deleted file]
appendices/editor-configuration/emacs/text.xml [deleted file]
appendices/editor-configuration/text.xml [deleted file]
appendices/editor-configuration/vim/text.xml [deleted file]
appendices/editor-configuration/xemacs/text.xml [deleted file]
appendices/further-reading/text.xml [deleted file]
appendices/text.xml [deleted file]
appendices/todo-list/text.xml [deleted file]
archs/alpha/text.xml [deleted file]
archs/amd64/text.xml [deleted file]
archs/mips/text.xml [deleted file]
archs/ppc/text.xml [deleted file]
archs/sparc/text.xml [deleted file]
archs/text.xml [deleted file]
archs/x86/text.xml [deleted file]
devbook.xsl [deleted file]
devmanual.css [deleted file]
ebuild-writing/common-mistakes/text.xml [deleted file]
ebuild-writing/eapi/text.xml [deleted file]
ebuild-writing/error-handling/text.xml [deleted file]
ebuild-writing/file-format/text.xml [deleted file]
ebuild-writing/functions/diagram.svg [deleted file]
ebuild-writing/functions/pkg_config/text.xml [deleted file]
ebuild-writing/functions/pkg_nofetch/text.xml [deleted file]
ebuild-writing/functions/pkg_postinst/text.xml [deleted file]
ebuild-writing/functions/pkg_postrm/text.xml [deleted file]
ebuild-writing/functions/pkg_preinst/text.xml [deleted file]
ebuild-writing/functions/pkg_prerm/text.xml [deleted file]
ebuild-writing/functions/pkg_setup/text.xml [deleted file]
ebuild-writing/functions/src_compile/build-environment/text.xml [deleted file]
ebuild-writing/functions/src_compile/building/text.xml [deleted file]
ebuild-writing/functions/src_compile/configuring/text.xml [deleted file]
ebuild-writing/functions/src_compile/distutils/text.xml [deleted file]
ebuild-writing/functions/src_compile/no-build-system/text.xml [deleted file]
ebuild-writing/functions/src_compile/text.xml [deleted file]
ebuild-writing/functions/src_install/text.xml [deleted file]
ebuild-writing/functions/src_prepare/text.xml [deleted file]
ebuild-writing/functions/src_test/text.xml [deleted file]
ebuild-writing/functions/src_unpack/autopackage/text.xml [deleted file]
ebuild-writing/functions/src_unpack/cvs-sources/text.xml [deleted file]
ebuild-writing/functions/src_unpack/deb-sources/text.xml [deleted file]
ebuild-writing/functions/src_unpack/epatch/text.xml [deleted file]
ebuild-writing/functions/src_unpack/other-formats/text.xml [deleted file]
ebuild-writing/functions/src_unpack/rpm-sources/text.xml [deleted file]
ebuild-writing/functions/src_unpack/svn-sources/text.xml [deleted file]
ebuild-writing/functions/src_unpack/text.xml [deleted file]
ebuild-writing/functions/src_unpack/tla-sources/text.xml [deleted file]
ebuild-writing/functions/text.xml [deleted file]
ebuild-writing/messages/text.xml [deleted file]
ebuild-writing/misc-files/changelog/text.xml [deleted file]
ebuild-writing/misc-files/metadata/text.xml [deleted file]
ebuild-writing/misc-files/patches/text.xml [deleted file]
ebuild-writing/misc-files/text.xml [deleted file]
ebuild-writing/text.xml [deleted file]
ebuild-writing/use-conditional-code/text.xml [deleted file]
ebuild-writing/users-and-groups/text.xml [deleted file]
ebuild-writing/using-eclasses/text.xml [deleted file]
ebuild-writing/variables/text.xml [deleted file]
eclass-reference/bash-completion.eclass/text.xml [deleted file]
eclass-reference/cvs.eclass/text.xml [deleted file]
eclass-reference/eutils.eclass/text.xml [deleted file]
eclass-reference/fdo-mime.eclass/text.xml [deleted file]
eclass-reference/flag-o-matic.eclass/text.xml [deleted file]
eclass-reference/gnome2.eclass/text.xml [deleted file]
eclass-reference/rpm.eclass/text.xml [deleted file]
eclass-reference/subversion.eclass/text.xml [deleted file]
eclass-reference/text.xml [deleted file]
eclass-writing/text.xml [deleted file]
function-reference/build-functions/text.xml [deleted file]
function-reference/install-functions/text.xml [deleted file]
function-reference/message-functions/text.xml [deleted file]
function-reference/query-functions/text.xml [deleted file]
function-reference/sandbox-functions/text.xml [deleted file]
function-reference/text.xml [deleted file]
general-concepts/autotools/diagram.svg [deleted file]
general-concepts/autotools/text.xml [deleted file]
general-concepts/config-protect/text.xml [deleted file]
general-concepts/cvs-to-rsync/diagram.svg [deleted file]
general-concepts/cvs-to-rsync/text.xml [deleted file]
general-concepts/dependencies/text.xml [deleted file]
general-concepts/distributed-building/text.xml [deleted file]
general-concepts/ebuild-revisions/text.xml [deleted file]
general-concepts/emerge-and-ebuild/diagram.svg [deleted file]
general-concepts/emerge-and-ebuild/text.xml [deleted file]
general-concepts/features/text.xml [deleted file]
general-concepts/filesystem/text.xml [deleted file]
general-concepts/herds-and-projects/text.xml [deleted file]
general-concepts/install-destinations/text.xml [deleted file]
general-concepts/licenses/text.xml [deleted file]
general-concepts/linguas/text.xml [deleted file]
general-concepts/manifest/text.xml [deleted file]
general-concepts/mirrors/diagram.svg [deleted file]
general-concepts/mirrors/text.xml [deleted file]
general-concepts/overlay/text.xml [deleted file]
general-concepts/pic/text.xml [deleted file]
general-concepts/portage-cache/text.xml [deleted file]
general-concepts/privileges/text.xml [deleted file]
general-concepts/sandbox/text.xml [deleted file]
general-concepts/slotting/text.xml [deleted file]
general-concepts/text.xml [deleted file]
general-concepts/tree/text.xml [deleted file]
general-concepts/use-flags/text.xml [deleted file]
general-concepts/user-environment/text.xml [deleted file]
general-concepts/virtuals/text.xml [deleted file]
hosted-projects/text.xml [deleted file]
icons/icon_mini-creativecommons.png [deleted file]
icons/icon_mini-css.png [deleted file]
icons/icon_mini-gentoo.png [deleted file]
icons/icon_mini-xhtml.png [deleted file]
icons/icon_mini-xml.png [deleted file]
keywording/text.xml [deleted file]
profiles/categories/text.xml [deleted file]
profiles/info_files/text.xml [deleted file]
profiles/make.defaults/text.xml [deleted file]
profiles/package.mask/text.xml [deleted file]
profiles/packages/text.xml [deleted file]
profiles/profiles.desc/text.xml [deleted file]
profiles/text.xml [deleted file]
profiles/updates/text.xml [deleted file]
profiles/use.desc/text.xml [deleted file]
profiles/use.mask/text.xml [deleted file]
profiles/virtuals/text.xml [deleted file]
quickstart/text.xml [deleted file]
tasks-reference/completion/text.xml [deleted file]
tasks-reference/environment/text.xml [deleted file]
tasks-reference/init-scripts/text.xml [deleted file]
tasks-reference/pam/text.xml [deleted file]
tasks-reference/perl-modules/text.xml [deleted file]
tasks-reference/text.xml [deleted file]
text.xml [deleted file]
tools-reference/bash/text.xml [deleted file]
tools-reference/cat/text.xml [deleted file]
tools-reference/cut/text.xml [deleted file]
tools-reference/diff-and-patch/text.xml [deleted file]
tools-reference/echangelog/text.xml [deleted file]
tools-reference/echo/text.xml [deleted file]
tools-reference/ekeyword/text.xml [deleted file]
tools-reference/false-and-true/text.xml [deleted file]
tools-reference/find/text.xml [deleted file]
tools-reference/gentoo-syntax/text.xml [deleted file]
tools-reference/grep/text.xml [deleted file]
tools-reference/head-and-tail/text.xml [deleted file]
tools-reference/sed/text.xml [deleted file]
tools-reference/sort/text.xml [deleted file]
tools-reference/text.xml [deleted file]
tools-reference/tr/text.xml [deleted file]
tools-reference/uniq/text.xml [deleted file]
xsl/lang.highlight.c.xsl [deleted file]
xsl/lang.highlight.ebuild.xsl [deleted file]
xsl/lang.highlight.m4.xsl [deleted file]
xsl/lang.highlight.make.xsl [deleted file]
xsl/lang.highlight.sgml.xsl [deleted file]
xsl/str.tokenize.function.xsl [deleted file]

diff --git a/MOVED b/MOVED
new file mode 100644 (file)
index 0000000..20b4cf2
--- /dev/null
+++ b/MOVED
@@ -0,0 +1,8 @@
+The devmanual repository has been moved to git.overlays.gentoo.org.
+Gitweb: http://git.overlays.gentoo.org/gitweb/?p=proj/devmanual.git;a=summary
+Git Access (read-only): git://git.overlays.gentoo.org/proj/devmanual.git
+Git via HTTP (read-only): http://git.overlays.gentoo.org/gitroot/proj/devmanual.git
+Git via SSH (read/write): git+ssh://git@git.overlays.gentoo.org/proj/devmanual.git
+
+If you have any further questions feel free to join our IRC channel (#gentoo-qa)
+on FreeNode or you can reach us by mail as well qa@gentoo.org.
diff --git a/Makefile b/Makefile
deleted file mode 100644 (file)
index 70e209a..0000000
--- a/Makefile
+++ /dev/null
@@ -1,19 +0,0 @@
-text_files := $(shell find -name "text.xml" | sed -e "s/text.xml$$/index.html/")
-image_files := $(shell find -name "*.svg" | sed -e "s/svg$$/png/")
-
-all: $(text_files) $(image_files)
-
-%index.html : %text.xml
-       xsltproc devbook.xsl $< > $@ 
-
-# Someone should figure out a way to put this to the pattern
-index.html : text.xml
-       xsltproc devbook.xsl $< > $@ 
-
-%.png : %.svg
-       convert $< $@
-
-clean:
-       @find . -name "*.png" -a \! -path "./icons/*" -exec rm -v {} +
-       @find . -name "index.html" -exec rm -v {} +
-
diff --git a/appendices/common-problems/text.xml b/appendices/common-problems/text.xml
deleted file mode 100644 (file)
index b0a7e58..0000000
+++ /dev/null
@@ -1,249 +0,0 @@
-<?xml version="1.0"?>
-<guide self="appendices/common-problems/">
-<chapter>
-<title>Common Problems</title>
-<body>
-
-<p>
-This page provides suggestions on how to handle various commonly seen errors
-and QA notices.
-</p>
-
-<section>
-<title>Handling QA Notices</title>
-<body>
-
-<p>
-The <c>ebuild.sh</c> part of portage includes a number of checks for common
-problems. These can result in a 'QA Notice' message being displayed. You must
-not rely upon portage always generating these messages <d/> they are not a
-substitute for proper testing and QA by developers.
-</p>
-
-<note>
-Some eclasses output messages in the same format. These are not
-covered here.
-</note>
-
-<subsection>
-<title>QA Notice -- USE Flag foo not in IUSE</title>
-<body>
-
-<p>
-With the exception of 'special' flags (the arch flags and <c>USE_EXPAND</c>
-variables), all <c>USE</c> flags used by a package must be included in <c>IUSE</c>.
-See <uri link="::ebuild-writing/variables/#IUSE"/> and
-<uri link="::general-concepts/use-flags/"/>.
-</p>
-
-</body>
-</subsection>
-
-<subsection>
-<title>QA Notice -- foo in global scope</title>
-<body>
-
-<p>
-This message occurs when various tools are inappropriately used in global scope.
-Remember that no external code should be run globally. Depending upon the tool
-in use, there are various alternatives:
-</p>
-
-<dl>
-  <dt>
-    <c>sed</c>, <c>awk</c>, <c>grep</c>, <c>egrep</c>, <c>cut</c> etc
-  </dt>
-  <dd>
-    <p>
-    Usually when any of the above are used in global scope, it is to manipulate
-    a version or program name string. These should be avoided in favour of
-    pure <c>bash</c> constructs. The <c>versionator</c> eclass is often of use here.
-    See <uri link="::ebuild-writing/variables/#Version Formatting Issues"/>,
-    <c>man versionator.eclass</c> and <uri
-    link="::tools-reference/bash/#Bash Variable Manipulation"/>.
-    </p>
-  </dd>
-  <dt>
-    <c>has_version</c>, <c>best_version</c>
-  </dt>
-  <dd>
-    <p>
-    Calls to either of these globally indicates a serious problem. You must <b>not</b>
-    have metadata varying based upon system-dependent information <d/> see
-    <uri link="::general-concepts/portage-cache/"/>. You should rewrite your ebuilds
-    to correctly use dependencies.
-    </p>
-  </dd>
-  <dt>
-    <c>python</c>, <c>perl</c> etc
-  </dt>
-  <dd>
-    <p>
-    Ebuilds are <c>bash</c> scripts. Offloading anything you don't know how to do
-    in <c>bash</c> onto another language is not acceptable <d/> if nothing else,
-    because not all users will always have a full system when ebuilds are
-    sourced.
-    </p>
-  </dd>
-</dl>
-
-</body>
-</subsection>
-
-<subsection>
-<title>QA Notice -- foo is setXid, dynamically linked and using lazy bindings</title>
-<body>
-
-<p>
-Dynamically linked setXid applications should not use lazy bindings when linking
-for security reasons. If this message is shown, you have a couple of options:
-</p>
-
-<ul>
-  <li>
-    Modify the package's Makefile (or equivalent) to use <c>-Wl,-z,now</c> when
-    linking. This solution is preferred.
-  </li>
-  <li>
-    Use <c>append-ldflags</c> (see <uri
-    link="ebuild-writing/functions/src_compile/build-environment/#Adding Additional Flags"/>)
-    to add <c>-Wl,-z,now</c>. This will affect <e>all</e> binaries installed, not just the setXid ones.
-  </li>
-</ul>
-
-</body>
-</subsection>
-
-<subsection>
-<title>QA Notice -- ECLASS foo inherited illegally</title>
-<body>
-
-<p>
-All eclass inherits must be unconditional, or based purely upon static
-machine-independent criteria (<c>PN</c> and <c>PV</c> are most common here). See
-<uri link="::general-concepts/portage-cache/"/>.
-</p>
-
-<p>
-You may see this warning in situations where there is not actually any illegal
-inheritance occurring. Most commonly:
-</p>
-
-<ul>
-  <li>
-    When unmerging a package which was installed using an old portage version that
-    did not record inheritance.
-  </li>
-  <li>
-    When working with eclasses in an overlay with a stale cache. See <uri
-    link="::general-concepts/overlay/#Overlay and Eclasses"/>.
-  </li>
-  <li>
-    When working with a stale portage cache.
-  </li>
-</ul>
-
-<p>
-You should manually check against the rules described in
-<uri link="::general-concepts/portage-cache/"/> if
-you see this notice locally. If you see this notice when working with a pure
-<c>emerge sync</c> over <c>rsync</c> setup, it is probably a genuine issue.
-</p>
-
-</body>
-</subsection>
-
-<todo>
-from vapier:
-TEXTREL's ... binary files which contain text relocations ... see
-'prepstrip' for a full description unsafe files ... basically files that
-are setid and writable by Other users i've added the following QA checks to
-portage HEAD (no idea when they'll hit a release): Insecure RUNPATHs ...
-binary files which have RUNPATH's encoded in them which are in +t
-directories Executable stacks ... binary files whose stack is marked with
-+x ... will bomb on amd64 for example
-</todo>
-
-</body>
-</section>
-
-<section>
-<title>Handling <c>repoman</c> Messages</title>
-<body>
-
-<todo>
-write me
-</todo>
-
-</body>
-</section>
-
-<section>
-<title>Handling Access Violations</title>
-<body>
-
-<p>
-Portage uses a sandbox for certain phases of the build process. This prevents a
-package from accidentally writing outside 'safe' locations. See
-<uri link="::general-concepts/sandbox/"/> for details.
-</p>
-
-<p>
-If a package violates the sandbox, an error such as the following will be given
-(assuming that the sandbox is enabled and working on the test system, which
-should always be the case for developer boxes):
-</p>
-
-<pre>
-    --------------------------- ACCESS VIOLATION SUMMARY ---------------------------
-    LOG FILE = "/tmp/sandbox-app-misc_-_breakme-1-31742.log"
-
-    open_wr:   /big-fat-red-error
-    --------------------------------------------------------------------------------
-</pre>
-
-<p>
-The <c>open_wr</c> means the package tried to open for write a file that is not
-inside write-permitted areas. In this case, the file in question is
-<c>/big-fat-red-error</c>.
-</p>
-
-<p>
-Other error messages exist for read-restricted areas <d/> these are rarely used in
-ebuilds.
-</p>
-
-<p>
-Access violations most commonly occur during the install phase. See
-<c>src_install</c> and <uri link="::general-concepts/install-destinations/"/>
-for discussion.
-</p>
-
-<p>
-Sometimes problems can also occur with packages attempting to write to
-<c>${HOME}</c>. To get around this, it is usually sufficient to trick the build
-system into using a safer location. For example, the <c>fluxbox</c> menu generator
-tries to work in <c>${HOME}/.fluxbox</c> <d/> to get around this, the following is
-used:
-</p>
-
-<codesample lang="ebuild">
-ebegin "Creating a menu file (may take a while)"
-mkdir -p "${T}/home/.fluxbox" || die "mkdir home failed"
-MENUFILENAME="${S}/data/menu" MENUTITLE="Fluxbox ${PV}" \
-    CHECKINIT="no. go away." HOME="${T}/home" \
-    "${S}"/util/fluxbox-generate_menu -is -ds \
-    || die "menu generation failed"
-eend $?
-</codesample>
-
-<p>
-In this situation, providing a fake home directory is all that is needed.
-</p>
-
-</body>
-</section>
-
-</body>
-</chapter>
-</guide>
diff --git a/appendices/contributing/text.xml b/appendices/contributing/text.xml
deleted file mode 100644 (file)
index b566362..0000000
+++ /dev/null
@@ -1,140 +0,0 @@
-<?xml version="1.0"?>
-<guide self="appendices/contributing/">
-<chapter>
-<title>Contributing to This Document</title>
-
-<body>
-<p>
-Contributions for this document are very welcome. Whether you've found a typo
-or have written an entire new section, the best way to get in touch is via Bugzilla
-at <uri link="http://bugs.gentoo.org">bugs.gentoo.org</uri>.
-</p>
-
-<p>
-The editors reserve the right to modify submissions as they see fit. Any
-substantial changes will of course be discussed with the submitter first <d/>
-unless explicitly requested, minor typo corrections and formatting fixes will
-not be discussed.
-</p>
-
-<p>
-This document is licensed under the <uri link="http://creativecommons.org/licenses/by-sa/2.0/">
-Creative Commons Attribution-ShareAlike 2.0 License </uri>. If this is a problem,
-don't submit anything.
-</p>
-
-<p>
-This document is produced using the DevBook XML build system. You can download
-a snapshot of the system as well as the relevant XML files from Subversion. You
-can also view the XML of any page by replacing <c>index.html</c> with
-<c>text.xml</c> in the URL. If you'd rather just work with plain text, that's
-fine too <d/> the formatting can be easily done by someone else (meaning, us).
-</p>
-
-<subsection>
-  <title>Where to find the sources</title>
-  <body>
-
-<p>
-  Currently, sources are hosted on git.gentoo.org. For current Gentoo developers,
-  access is at <c>git+ssh://git.gentoo.org/var/gitroot/devmanual.git</c>. Non-developers
-  can find it via anonymous Git at <c>git://anongit.gentoo.org/devmanual.git</c>.
-</p>
-
-<p>
-  To build the devmanual, simply run <c>make</c> in the <c>trunk</c> directory of the repository.
-  You need <c>xsltproc</c> (from <c>dev-libs/libxslt</c>) for the XML to HTML
-  conversion and optionally also <c>ImageMagick</c> for the SVG to PNG conversion
-  used in some of the figures throughout the document.
-</p>
-  </body>
-</subsection>
-
-</body>
-
-<section>
-<title>Quick Introduction to DevBook XML</title>
-<body>
-
-<p>
-DevBook XML is heavily based on <uri link="http://www.gentoo.org/doc/en/xml-guide.xml">
-GuideXML</uri> and many tags are similar, if not the same. The main differences
-occur in layout which are designed to make a large-scale publication easier
-to produce and manage using a hierarchical tree system. Before starting off you
-really should first examine the GuideXML guide in a reasonable amount of depth.
-</p>
-
-<subsection>
-<title>Differences from GuideXML</title>
-<body>
-
-<dl>
-  <dt>
-    Indentation
-  </dt>
-  <dd>
-    <p>
-      Indent when needed <d/> you should not indent any section flow elements such as
-      <c>&lt;subsection&gt;</c> but do indent tables, lists and definition lists.
-      Do <e>not</e> indent text in ordinary paragraph blocks.
-    </p>
-  </dd>
-  <dt>
-    Code Samples
-  </dt>
-  <dd>
-    <p>
-      You can use the normal GuideXML tag <c>&lt;pre&gt;</c> when you need no syntax
-      highlighting. When you need syntax highlighting use the <c>&lt;codesample&gt;</c>
-      tag along with a <c>lang</c> attribute <d/> usually you want this to be set to
-      <c>ebuild</c> to syntax highlight ebuild code snippets.
-    </p>
-  </dd>
-  <dt>
-    Hierarchy
-  </dt>
-  <dd>
-    <p>
-      The whole document is organized as a tree. Each directory can contain one
-      document. Each document can inherit multiple sub-documents using the
-      <c>&lt;include&gt;</c> flag. You <b>must</b> ensure that the <c>self</c> tag
-      in each document correctly points to the relative path of the document from
-      the root node so that the tree-walking algorithms work correctly.
-    </p>
-  </dd>
-</dl>
-
-</body>
-</subsection>
-</body>
-</section>
-
-<section>
-<title>Style Guidelines</title>
-<body>
-
-<ul>
-  <li>
-  This document is in British English. Submissions in other kinds of English are
-  welcome, but they may have their spelling corrected.
-  </li>
-  <li>
-  Third person form should be used rather than first.
-  </li>
-  <li>
-  This is not a formal document. The writing style is intended to be
-  professional but readable.
-  </li>
-  <li>
-  When using in-sentence hyphens as punctuation <d/> like this <d/> use a space,
-  followed by the <c>&lt;d/&gt;</c> tag. The build system will automatically turn
-  this into a proper Unicode long dash.
-  </li>
-</ul>
-
-</body>
-</section>
-</chapter>
-
-</guide>
-
diff --git a/appendices/contributors/text.xml b/appendices/contributors/text.xml
deleted file mode 100644 (file)
index 7e3202c..0000000
+++ /dev/null
@@ -1,63 +0,0 @@
-<?xml version="1.0"?>
-<guide self="appendices/contributors/">
-<chapter>
-<title>Contributions</title>
-<body>
-
-<p>
-This page lists the contributions to the Gentoo Development Guide:
-</p>
-
-<authors>
-<author name="Ciaran McCreesh" email="ciaran.mccreesh@blueyonder.co.uk">
-  Main Content
-</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"/>,
-  <uri link="::eclass-reference/subversion.eclass"/>
-</author>
-<author name="Robert Coie" email="rac@gentoo.org">
-  <uri link="::appendices/editor-configuration/xemacs"/>
-</author>
-<author name="Tom Martin" email="slarti@gentoo.org">
-  <uri link="::appendices/editor-configuration/emacs"/>,
-  <uri link="::ebuild-writing/functions/src_unpack/svn-sources"/>,
-  <uri link="::general-concepts/use-flags/#Conflicting USE Flags"/>
-</author>
-<author name="Paul Varner" email="fuzzyray@gentoo.org">
-  <uri link="::ebuild-writing/functions/src_unpack/rpm-sources"/>
-</author>
-<author name="Ilya Volynets-Evenbakh" email="iluxa@gentoo.org">
-  <uri link="::archs/mips/#MIPS ABIs"/>
-</author>
-<author name="Diego Pettenò" email="flameeyes@gentoo.org">
-  <uri link="::tasks-reference/pam"/>,
-  <uri link="::general-concepts/autotools/#aclocal and m4 Files"/>
-</author>
-<author name="Fernando J. Pereda" email="ferdy@gentoo.org">
-  <uri link="::archs/alpha"/>
-</author>
-<author name="Simon Stelling" email="blubb@gentoo.org">
-  <uri link="::archs/amd64"/>
-</author>
-<author name="Alin Dobre" email="alin@gentoo.org">
-  <uri link="::tools-reference/echo"/>
-</author>
-<author name="Joseph Jezak" email="josejx@gentoo.org">
-  <uri link="::archs/ppc"/>
-</author>
-<author name="Tim Yamin" email="plasm@roo.me.uk">
-  XSL Stylesheets, previous maintainer
-</author>
-<author name="Mark Loeser" email="halcy0n@gentoo.org">
-  XSL Stylesheets, current maintainer
-</author>
-</authors>
-
-</body>
-</chapter>
-</guide>
diff --git a/appendices/editor-configuration/emacs/text.xml b/appendices/editor-configuration/emacs/text.xml
deleted file mode 100644 (file)
index 233bffe..0000000
+++ /dev/null
@@ -1,116 +0,0 @@
-<?xml version="1.0"?>
-<guide self="appendices/editor-configuration/emacs/">
-<chapter>
-<title>Configuring GNU Emacs</title>
-
-<section>
-<title>UTF-8 support</title>
-<body>
-
-<p>
-Emacs 21 has built-in Unicode support, and (fortunately) it supports
-UTF-8 far better than UTF-16 and other variants. Some extensions to this
-functionality are available in the package <c>app-emacs/mule-ucs</c>, although
-this is not necessary (and I would not recommend it unless absolutely
-necessary, as the potential for unexpected bugs or quirky behaviour is
-increased). The best solution is using Emacs 22 or higher as encoding
-support has been greatly improved.
-</p>
-
-<p>
-In versions of Emacs below 21.3, and a non-UTF-8 locale is used when
-opening a UTF-8 file, auto-detection of the character set is effectively
-disabled and characters will be garbled. The UTF-8 character set can be
-preferred with <c>M-x prefer-coding-system</c> and entering <c>utf-8</c> when
-prompted. Otherwise, it is necessary to tell Emacs that a UTF-8 file is
-being opened by prefixing the <c>C-x C-f</c> or <c>C-x C-v</c> command with
-<c>C-x C-m c utf-8 RET</c>. As a diagnostic measure, the coding system currently
-in use can be determined with <c>C-h C &lt;RET&gt;</c>.
-</p>
-
-<p>
-Newer Emacs versions will autodetect the coding system for given text.
-</p>
-
-<p>
-If it is desired to prefer UTF-8 to the regular character set,
-the following can be used inside of the Emacs startup file:
-</p>
-
-<pre>
-    (prefer-coding-system 'utf-8)
-</pre>
-
-<p>
-For specifying coding system to use on a per-file basis, the
-<c>modify-coding-system</c> function can be used.
-</p>
-</body>
-</section>
-
-<section>
-<title>Configuration tips and tricks</title>
-<body>
-
-<p>
-Files must end with a newline, in order to let tools like <e>diff</e>
-operate properly. To avoid accidental deletions, setting
-<e>(setq require-final-newline 'ask)</e> in your startup file will
-automatically check for the existence of it and ask you to add one.
-</p>
-
-<p>
-Other useful settings can be disabled backup files
-(by <e>(setq make-backup-files nil)</e> and
-<e>(setq vc-cvs-stay-local nil)</e>), so you don't clutter CVS
-directories and confuse repoman with it (by adding unnecessary entries
-into a Manifest file e.g.). Emacs can even contact the outside world
-by using the X servers clipboard abilities when yanking, which is
-activated by <e>(setq x-select-enable-clipboard t)</e>.
-</p>
-
-</body>
-</section>
-
-<section>
-<title>Gentoo specific additions</title>
-<body>
-
-<p>
-For easy editing of ebuilds an Emacs mode has been created, which is
-found in the package <e>app-emacs/gentoo-syntax</e>.
-It supports ebuilds, eclasses and eselect files, highlights keywords
-and also provides a hook for your own customisation. 
-</p>
-
-</body>
-</section>
-
-<section>
-<title>Further Reading</title>
-<body>
-
-<ul>
-  <li>
-    <uri link="http://www.gnu.org/software/emacs/manual/emacs.html#Recognize%20Coding">
-    http://www.gnu.org/software/emacs/manual/emacs.html#Recognize%20Coding</uri>
-  </li>
-  <li>
-    <uri link="http://www.gnu.org/software/emacs/manual/emacs.html#Specify%20Coding">
-    http://www.gnu.org/software/emacs/manual/emacs.html#Specify%20Coding</uri>
-  </li>
-  <li>
-    <uri link="http://www.emacswiki.org/cgi-bin/wiki/UnicodeEncoding">
-    http://www.emacswiki.org/cgi-bin/wiki/UnicodeEncoding</uri>
-  </li>
-  <li>
-    <uri link="http://www.emacswiki.org/cgi-bin/wiki/ChangingEncodings">
-    http://www.emacswiki.org/cgi-bin/wiki/ChangingEncodings</uri>
-  </li>
-</ul>
-
-</body>
-</section>
-
-</chapter>
-</guide>
diff --git a/appendices/editor-configuration/text.xml b/appendices/editor-configuration/text.xml
deleted file mode 100644 (file)
index 071380c..0000000
+++ /dev/null
@@ -1,30 +0,0 @@
-<?xml version="1.0"?>
-<guide self="appendices/editor-configuration/">
-<chapter>
-<title>Editor Configuration</title>
-<body>
-
-<p>
-This section provides hints as to how to configue your text editor for working with ebuilds.
-</p>
-
-<todo>
-from vapier:  add a section for nano ... users just have to copy
-/etc/nanorc to ~/.nanorc and uncomment the sections for ebuilds
-</todo>
-
-</body>
-
-<section>
-<title>Contents</title>
-<body>
-<contentsTree/>
-</body>
-</section>
-</chapter>
-
-<include href="vim/"/>
-<include href="emacs/"/>
-<include href="xemacs/"/>
-
-</guide>
diff --git a/appendices/editor-configuration/vim/text.xml b/appendices/editor-configuration/vim/text.xml
deleted file mode 100644 (file)
index b85e25c..0000000
+++ /dev/null
@@ -1,20 +0,0 @@
-<?xml version="1.0"?>
-<guide self="appendices/editor-configuration/vim/">
-<chapter>
-<title>Configuring <c>vim</c> and <c>gvim</c></title>
-<body>
-
-<p>
-For full whitespace, character set, syntax and indent settings for
-<c>vim</c> and <c>gvim</c>, emerge the <c>app-vim/gentoo-syntax</c> package.
-</p>
-
-<p>
-When fixing ebuilds with broken whitespace, the <c>:retab!</c> command may be
-of interest. The ! is required to replace spaces with tabs.
-</p>
-
-</body>
-</chapter>
-</guide>
-
diff --git a/appendices/editor-configuration/xemacs/text.xml b/appendices/editor-configuration/xemacs/text.xml
deleted file mode 100644 (file)
index c1a1ee7..0000000
+++ /dev/null
@@ -1,48 +0,0 @@
-<?xml version="1.0"?>
-<guide self="appendices/editor-configuration/xemacs/">
-<chapter>
-<title>Configuring XEmacs for UTF-8</title>
-<body>
-
-<p>
-First, you need to have built <c>xemacs</c> itself with <c>USE=mule</c>.  Then, the
-<c>app-xemacs/mule-ucs</c> package is needed.  To autoload Unicode support,
-you can add the following to your <c>~/.xemacs/init.el</c>:
-</p>
-
-<pre>
-    (require 'un-define)
-</pre>
-
-<p>
-If automatic character set detection on files is not working properly,
-here are three commands that can help.
-</p>
-
-<ul>
-  <li>
-    <c>set-buffer-file-coding-system (C-x RET f)</c> changes the coding
-    system for the current file.
-  </li>
-  <li>
-    <c>set-default-buffer-file-coding-system (C-x RET F)</c> sets the default for
-    unsaved buffers and ASCII-looking files that have no obvious character
-    set markers for autodetection.
-  </li>
-  <li>
-    <c>universal-coding-system-argument (C-x RET c)</c>
-    lets you set the coding system for the next command, so issuing
-    this from a dired window immediately before opening a problematic file
-    is a tactic that can be of use when autodetection gets things
-    pathologically wrong.
-  </li>
-</ul>
-
-<p>
-The current coding system will be displayed near the left edge of the
-status line.
-</p>
-
-</body>
-</chapter>
-</guide>
diff --git a/appendices/further-reading/text.xml b/appendices/further-reading/text.xml
deleted file mode 100644 (file)
index 9fa79af..0000000
+++ /dev/null
@@ -1,66 +0,0 @@
-<?xml version="1.0"?>
-<guide self="appendices/further-reading/">
-<chapter>
-<title>Further Reading</title>
-<body>
-
-<p>
-This section lists some recommended further reading. These are real
-recommendations, not padding designed to make this document look important.
-</p>
-
-<section>
-<title>Books</title>
-<body>
-
-<dl>
-  <dt>
-    Mastering Regular Expressions
-  </dt>
-  <dd>
-    <p>
-    "Mastering Regular Expressions" by Jeffrey E. F. Friedl (O'Reilly,
-    ISBN 0-596-00289-0) is <b>the</b> book on regular expressions. Very readable and
-    devoid of the usual mathematical jargon that tends to fill up these kinds of
-    books. <uri link="http://www.oreilly.com/catalog/regex2/">Publisher's page</uri>
-    </p>
-  </dd>
-</dl>
-
-</body>
-</section>
-
-<section>
-<title>Articles</title>
-<body>
-
-<dl>
-  <dt>
-    Making Packager-Friendly Software
-  </dt>
-  <dd>
-    <p>
-    <uri link="http://www.onlamp.com/pub/a/onlamp/2005/03/31/packaging.html">Making
-    Packager-Friendly Software</uri> by Julio M. Merino Vidal describes various things
-    that can be done by upstream software providers to make life easy for the
-    distribution people (that means you).
-    </p>
-  </dd>
-  <dt>
-    How to Report Bugs Effectively
-  </dt>
-  <dd>
-    <p>
-    <uri link="http://freshmeat.net/articles/view/149">How to Report Bugs
-    Effectively</uri> by Simon Tatham is a good overview of effective bug reporting.
-    </p>
-  </dd>
-</dl>
-
-</body>
-</section>
-
-</body>
-</chapter>
-</guide>
-
diff --git a/appendices/text.xml b/appendices/text.xml
deleted file mode 100644 (file)
index dc326a6..0000000
+++ /dev/null
@@ -1,27 +0,0 @@
-<?xml version="1.0"?>
-<guide self="appendices/">
-<chapter>
-<title>Appendices</title>
-
-<body>
-<p>
-This section incorporates various auxiliary documents which may be useful as a reference.
-</p>
-</body>
-
-<section>
-<title>Contents</title>
-<body>
-<contentsTree/>
-</body>
-</section>
-</chapter>
-
-<include href="editor-configuration/"/>
-<include href="common-problems/"/>
-<include href="further-reading/"/>
-<include href="contributing/"/>
-<include href="contributors/"/>
-<include href="todo-list/"/>
-
-</guide>
diff --git a/appendices/todo-list/text.xml b/appendices/todo-list/text.xml
deleted file mode 100644 (file)
index e8175c5..0000000
+++ /dev/null
@@ -1,13 +0,0 @@
-<?xml version="1.0"?>
-<guide self="appendices/todo-list/">
-<chapter>
-<title>TODO List</title>
-<body>
-<p>
-This TODO list is automatically generated from the <c>&lt;todo&gt;</c> directives in other documents.
-</p>
-
-<contentsTree root="" extraction="todo"/>
-</body>
-</chapter>
-</guide>
diff --git a/archs/alpha/text.xml b/archs/alpha/text.xml
deleted file mode 100644 (file)
index b8662fe..0000000
+++ /dev/null
@@ -1,159 +0,0 @@
-<?xml version="1.0"?>
-<guide self="archs/alpha/">
-<chapter>
-<title>Arch Specific Notes -- Alpha</title>
-<body>
-
-<p>
-The Alpha port uses the <c>alpha</c> keyword. It focuses upon HP (formerly Compaq
-(formerly DEC)) hardware. This covers from <c>ev4</c> (known as 21064) through
-<c>ev7z</c> (known as 21364a).
-</p>
-
-<section>
-<title>Alpha Kernel and Userland ABIs</title>
-<body>
-
-<p>
-All Alpha systems use a pure 64 bit kernel and a pure 64 bit userland.
-</p>
-
-<p>
-All Alpha systems support both little and big endian <d/> however, Linux only uses
-little endian.
-</p>
-
-</body>
-</section>
-
-<section>
-<title>Additional Alpha Keywording Requirements</title>
-<body>
-
-<p>
-It is generally expected that anyone who does keywording for Alpha should be on
-the <c>alpha@</c> alias. However the Alpha team is happy if maintainers keyword
-their packages when they have access to Alpha hardware, although the team would
-like to know about it.
-</p>
-
-</body>
-</section>
-
-<section>
-<title>Alpha Instruction Set and Performance Notes</title>
-<body>
-
-<p>
-There are six basic Alpha instructions set standards:
-</p>
-
-<ul>
-  <li>
-    <c>ev4</c> or <c>ev45</c>. The <c>ev4</c> was the first Alpha processor of the Alpha
-    family. It featured one integer pipeline and one floating-point pipeline.
-    The <c>ev45</c> is a modified <c>ev4</c> with double both Data and Instruction cache
-    (D-Cache and I-Cache respectively); it also featured a division optimization.
-  </li>
-  <li>
-    <c>ev5</c> is an evolution of the <c>ev45</c>. The number of pipelines was doubled
-    and the floating-point pipelines run in 9 stages rather than in 10. The
-    <c>ev5</c> supports 3 cache levels.
-  </li>
-  <li>
-    <c>ev56</c> added the BWX extension to load/store data in 8 or 16 bit quanta.
-  </li>
-  <li>
-    <c>pca56</c> added a new set, MVI (Motion Video Instructions), aimed to
-    accelerate video and audio calculations.
-  </li>
-  <li>
-    <c>ev6</c> supports all extensions supported by the <c>pca56</c> and a new set, FIX,
-    meant to move data between integer and floating-point registers and for square
-    root.
-  </li>
-  <li>
-    <c>ev67</c> is an evolution of the <c>ev6</c>, in addition it supports a new set.
-    CIX adds instructions for counting and finding bits.
-  </li>
-</ul>
-
-<p>
-When no <c>-mcpu</c> option is passed to <c>gcc</c> it defaults to the processor on
-which the compiler was built.
-</p>
-
-<p>
-The <c>-mieee</c> flag <b>should</b> always be used unless you have a deep knowledge
-of the Alpha architecture, so the comments on
-<uri link="::general-concepts/user-environment#Not Filtering Variables"/> are
-really important on Alpha.
-</p>
-
-</body>
-</section>
-
-<section>
-<title>Notes on Alpha and PIC</title>
-<body>
-
-<p>
-General <uri link="::general-concepts/pic/"/> policy also applies to Alpha. In fact,
-Alpha systems complain loudly if you try to link PIC and non-PIC code. Usually
-this results in errors during the compilation aborting emerge.
-</p>
-
-</body>
-</section>
-
-<section>
-<title>Contacting the Alpha Team</title>
-<body>
-
-<p>
-The Alpha team can be contacted:
-</p>
-
-<ul>
-  <li>
-    Via Bugzilla bugs assigned to <c>alpha@</c>
-  </li>
-  <li>
-    Via email to the <c>alpha@</c> email alias
-  </li>
-  <li>
-    Via email to the <c>gentoo-alpha</c> mailing list
-  </li>
-  <li>
-    Via the <c>#gentoo-alpha</c> IRC channel on Freenode
-  </li>
-</ul>
-
-</body>
-</section>
-
-<section>
-<title>Other Resources</title>
-<body>
-
-<ul>
-  <li>
-    <uri link="http://alpha.gentoo.org/">Gentoo Linux Alpha Development Project</uri>
-  </li>
-  <li>
-    <uri link="http://www.gentoo.org/doc/en/gentoo-alpha-faq.xml">Gentoo/Alpha FAQ</uri>
-  </li>
-  <li>
-    <uri link="http://www.gentoo.org/proj/en/base/alpha/doc/alpha-porting-guide.xml">Alpha Porting Guide</uri>
-  </li>
-  <li>
-    <uri link="http://forums.gentoo.org/viewforum-f-32.html">Gentoo on Alternative Architectures Forum</uri>
-  </li>
-</ul>
-
-</body>
-</section>
-
-</body>
-</chapter>
-</guide>
diff --git a/archs/amd64/text.xml b/archs/amd64/text.xml
deleted file mode 100644 (file)
index 996ded2..0000000
+++ /dev/null
@@ -1,734 +0,0 @@
-<?xml version="1.0"?>
-<guide self="archs/amd64/">
-<chapter>
-<title>Arch Specific Notes -- AMD64/EM64T</title>
-<body>
-
-<section>
-<title>Position Independent Code Issues</title>
-<body>
-
-<p>
-Gentoo Policy demands all shared objects to be compiled with <c>-fPIC</c>
-in <c>CFLAGS</c>. Since this is only a rule, you <e>can</e> break it on some arches.
-You might never notice it. On AMD64, this is a necessity, if shared objects aren't
-built with support for position independent code, the build process bails out
-with an error message like this:
-</p>
-
-<pre>
-foo.o: relocation R_X86_64_32 can not be used when making a shared
-object; recompile with -fPIC
-</pre>
-
-<subsection>
-<title>How to fix -fPIC issues</title>
-<body>
-
-<p>
-There are several ways to enforce <c>-fPIC</c> on shared objects, each with its
-pros and cons.
-</p>
-
-<subsubsection>
-<title><c>sed</c>'ing the Makefile</title>
-<body>
-
-<p>
-Sometimes, a simple <c>sed</c> command is enough to fix it, however, the statements
-normally aren't very readable and may fail when upstream changes the file.
-Please verify that you only change the <c>CFLAGS</c> for <e>shared</e> objects, not for
-the whole package.
-</p>
-
-</body>
-</subsubsection>
-
-<subsubsection>
-<title>Patching <c>Makefile.in</c>/<c>configure</c></title>
-<body>
-
-<p>
-This is more readable, and easier to send upstream.
-</p>
-
-</body>
-</subsubsection>
-
-</body>
-</subsection>
-
-<subsection>
-<title>How <b>not</b> to fix -fPIC issues</title>
-<body>
-
-<p>
-Do <b>not</b> patch the <c>Makefile</c> itself, since it is usually generated by the
-<c>configure</c> script and may vary heavily, so the patch could fail. Also, this
-doesn't help upstream at all.
-</p>
-
-<p>
-Another bad idea is to (ab)use <c>append-flags</c> function from
-<c>flag-o-matic.eclass</c>. Applying <c>-fPIC</c> on all objects should not be
-done.  It should only be applied to shared objects.
-</p>
-
-</body>
-</subsection>
-
-</body>
-</section>
-
-<section>
-<title>Assembler Optimisation</title>
-<body>
-
-<p>
-Modern x86 processors support special instruction sets like <c>mmx</c>, <c>sse</c>,
-<c>SSE2</c> and <c>3DNow!</c>. AMD64 also provides support for them, but in most
-cases, x86 assembler code is incompatible with AMD64 assembler. There are lots
-of packages that provide support through USE flags for these instruction sets.
-Originally, the USE flags were introduced to keep support for older processors
-such as the Pentium I that can't handle such code. Currently, all AMD64s support the
-same combination of extended instruction sets, so there is no reason to make 
-use of the mentioned USE flags. That's why these USE flags are hard-masked in 
-all AMD64-profiles. This doesn't mean we don't support the extensions 
-themselves, instead, we hard-enable them. 
-</p>
-
-<p>
-The following USE flags are masked on AMD64:
-</p>
-
-<ul>
-  <li>
-    mmx
-  </li>
-  <li>
-    mmx2
-  </li>
-  <li>
-    sse
-  </li>
-  <li>
-    sse2
-  </li>
-  <li>
-    3dnow
-  </li>
-  <li>
-    3dnowext
-  </li>
-</ul>
-
-</body>
-</section>
-
-<section>
-<title>Multilib on AMD64</title>
-<body>
-
-<p>
-The current AMD64 processors are able to natively run 32bit code on a 64bit
-kernel. Therefore, you can run programs compiled for x86 in an amd64 environment.
-However, 32bit applications need to be linked against 32bit libraries. Mixing
-them won't work. For this reason the libraries are sorted, 32bit libraries normally
-go to <c>/lib32</c> respectively <c>/usr/lib32</c>, the 64bit ones normally to <c>/lib64</c> or
-<c>/usr/lib64</c>. In a perfect world, you wouldn't have to read on. Unfortunately,
-that's not the case, and so it's a bit more complicated.
-</p>
-
-<subsection>
-<title>Multilib-Toolchain</title>
-<body>
-
-<subsubsection>
-<title>GCC</title>
-<body>
-
-<p>
-To generate 32bit code, we need a multilib-capable GCC. On other architectures,
-this functionality is enabled with the USE flag <c>multilib</c>. This is also true
-for amd64 with the <e>pre</e>-2005.0 profiles. From 2005.0 on, you have to choose
-whether you want multilib support or not by selecting the profile. Choose
-<c>2005.0/no-multilib</c> if you don't want it, all other profiles have the
-<c>multilib</c> USE flag masked, you're forced to it. With these profiles, GCC will
-produce x86-code whenever you add <c>-m32</c> to its command line. Adding <c>-m64</c>
-or omitting any bit-width option will default to producing 64bit code.
-</p>
-
-</body>
-</subsubsection>
-
-<subsubsection>
-<title>glibc</title>
-<body>
-
-<p>
-If you've chosen a multilib profile, glibc will be built twice, once 64bit and
-once 32bit. This is because nearly every application links against glibc. 
-To understand how this is done in the ebuild, read
-<uri link="::archs/amd64/#The ABI Variable"/>.
-</p>
-
-</body>
-</subsubsection>
-
-</body>
-</subsection>
-
-<subsection>
-<title>The <c>emul-linux-x86-*</c> packages</title>
-<body>
-
-<p>
-As you read above, 32bit applications must be linked against 32bit libraries.
-For that, we've put together the most used libraries and stuck them into the
-so-called <c>emul-linux-x86</c> packages, which are located in the
-<c>app-emulation</c> category.
-</p>
-
-<dl>
-  <dt>
-    emul-linux-x86-baselibs
-  </dt>
-  <dd>
-    <p>
-      Contains very basic libraries like zlib, pam, ncurses.
-    </p>
-  </dd>
-  <dt>
-    emul-linux-x86-compat
-  </dt>
-  <dd>
-    <p>
-      Contains very old libraries for compatibility with binary-only programs.
-    </p>
-  </dd>
-  <dt>
-    emul-linux-x86-glibc
-  </dt>
-  <dd>
-    <p>
-      Only used for compatibility reasons. This package is blocked by all
-      2005.0 profiles.
-    </p>
-  </dd>
-  <dt>
-    emul-linux-x86-gtklibs
-  </dt>
-  <dd>
-    <p>
-      The name says it <d/> GTK and its engines belong herein.
-    </p>
-  </dd>
-  <dt>
-    emul-linux-x86-nvidia
-  </dt>
-  <dd>
-    <p>
-      Obsolete, <c>media-video/nvidia-glx</c> includes the 32bit library.
-    </p>
-  </dd>
-  <dt>
-    emul-linux-x86-qtlibs
-  </dt>
-  <dd>
-    <p>
-      QT goes here.
-    </p>
-  </dd>
-  <dt>
-    emul-linux-x86-sdl
-  </dt>
-  <dd>
-    <p>
-      libsdl and friends are here.
-    </p>
-  </dd>
-  <dt>
-    emul-linux-soundlibs
-  </dt>
-  <dd>
-    <p>
-      alsa, libogg, just everything that is needed to get sound is located here.
-    </p>
-  </dd>
-  <dt>
-    emul-linux-x86-xlibs
-  </dt>
-  <dd>
-    <p>
-      Contains the basic X libraries.
-    </p>
-  </dd>
-</dl>
-
-<p>
-These packages only provide pre-compiled libraries. Currently, the
-archives are assembled manually, which is the main reason to keep the packages
-as tidy as possible. Do not include libraries that aren't commonly used.
-</p>
-
-<note>
-  The emul-packages might conflict with their native images, but only in
-  uncritical locations like <c>/usr/share</c> which are arch-independent anyway.
-</note>
-
-</body>
-</subsection>
-
-<subsection>
-<title><c>Libdir</c> Links</title>
-<body>
-
-<p>
-Currently, we provide several profiles, each with its own combination of <c>libdir</c>
-configurations.
-</p>
-
-<table>
-  <tr>
-    <th>
-      Profile
-    </th>
-    <th>
-      lib32
-    </th>
-    <th>
-      lib
-    </th>
-    <th>
-      lib64
-    </th>
-  </tr>
-  <tr>
-    <ti>
-      2004.3
-    </ti>
-    <ti>
-      *l->emul*
-    </ti>
-    <ti>
-      d64
-    </ti>
-    <ti>
-      *l->lib*
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      2004.3/lib64
-    </ti>
-    <ti>
-      *l->emul*
-    </ti>
-    <ti>
-      *l->64*
-    </ti>
-    <ti>
-      d64
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      >=2005.0
-    </ti>
-    <ti>
-      d32
-    </ti>
-    <ti>
-      *l->64*
-    </ti>
-    <ti>
-      d64
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      >=2005.0/no-multilib
-    </ti>
-    <ti>
-      d32
-    </ti>
-    <ti>
-      *l->64*
-    </ti>
-    <ti>
-      d64
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      >=2005.0/no-symlink
-    </ti>
-    <ti>
-      d32
-    </ti>
-    <ti>
-      d
-    </ti>
-    <ti>
-      d64
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      >=2005.0/no-symlink/no-lib32
-    </ti>
-    <ti>
-      inexistant
-    </ti>
-    <ti>
-      d32
-    </ti>
-    <ti>
-      d64
-    </ti>
-  </tr>
-</table>
-
-<dl>
-  <dt>
-    d
-  </dt>
-  <dd>
-    <p>
-      Directory containing mixed-bit objects
-    </p>
-  </dd>
-  <dt>
-    dXX
-  </dt>
-  <dd>
-    <p>
-      Directory containing XXbit objects
-    </p>
-  </dd>
-  <dt>
-    l->foo
-  </dt>
-  <dd>
-    <p>
-      Link to foo
-    </p>
-  </dd>
-</dl>
-
-<p>
-To always get the right path, you should use the function <c>$(get_libdir)</c> from
-<c>multilib.eclass</c>. It will always return the correct directory, on all arches.
-And of course it also takes care of the <c>ABI</c> variable.
-</p>
-
-</body>
-</subsection>
-
-<subsection>
-<title>The <c>multilib-strict</c> Feature</title>
-<body>
-
-<p>
-Many Makefiles assume that their libraries should go to <c>/usr/lib</c>, or
-<c>$(prefix)/lib</c>. This assumption can cause a serious mess if <c>/usr/lib</c>
-isn't a symlink to <c>/usr/lib64</c>. To find the bad packages, we have a portage feature
-called <b>multilib-strict</b>. It will prevent emerge from putting 64bit libraries
-into anything other than <c>(/usr)/lib64</c>.
-</p>
-
-<p>
-<c>multilib-strict</c> currently doesn't check perl5, gcc, gcc-lib and eclipse-3,
-this behaviour is controlled by the <c>MULTILIB_STRICT_EXEMPT</c> variable in
-<c>make.profile</c>.
-</p>
-
-<subsubsection>
-<title>How to fix ebuilds properly</title>
-<body>
-
-<p>
-In most cases, it's sufficient to use the <c>$(get_libdir)</c> function from
-<c>multilib.eclass</c>:
-</p>
-
-<codesample lang="ebuild">
-inherit multilib
-
-src_compile() {
-    econf \
-        --libdir=/usr/$(get_libdir)
-
-    emake || die
-}
-
-src_install() {
-    emake DESTDIR="${D}" install || die
-}
-</codesample>
-
-<p>
-Some packages provide really bad Makefiles which hard-code <c>/usr/lib</c>. Those
-should be <c>sed</c> -ed or patched. Don't forget to let upstream know about your
-modifications!
-</p>
-
-</body>
-</subsubsection>
-
-</body>
-</subsection>
-
-<subsection>
-<title>Headers and Multilib</title>
-<body>
-
-<p>
-Most C/C++ programs need standard header files like <c>types.h</c>. Some of them
-depend on architecture specific facts, e.g. <c>types.h</c> on the length
-of machine words. To ensure that we can compile both 32bit and 64bit
-applications and libraries, we treat <c>/usr/include/asm</c> a bit special.
-</p>
-
-<p>
-This is what <c>/usr/include/asm/types.h</c> looks like on a AMD64 box:
-</p>
-
-<codesample lang="c">
-/* Common header file autogenerated by create_ml_includes in multilib.eclass */
-#ifdef __i386__
-#include &lt;asm-i386/types.h&gt;
-#endif /* __i386__ */
-
-#ifdef __x86_64__
-#include &lt;asm-x86_64/types.h&gt;
-#endif /* __x86_64__ */
-</codesample>
-
-<p>
-As you can see, this is just a wrapper that decides which file you need
-depending on the the parameter <c>-D</c> given to gcc. You'll probably run into
-some troubles if you try to compile something by hand and forget to append
-<c>-D__x86_64__</c> to your <c>CFLAGS</c>. Of course, this is <b>not necessary</b> when
-using portage. For an explanation, see the <uri link="::archs/amd64/#The ABI Variable"/>
-section.
-</p>
-
-</body>
-</subsection>
-
-<subsection>
-<title>The ABI Variable</title>
-<body>
-
-<p>
-Whenever portage builds something on amd64, it has to decide whether it should
-be 32bit or 64bit. As stated in <uri link="::archs/amd64/#Headers and Multilib"/>
-the <c>__i386__</c> or <c>__x86_64__</c> respectively, is needed in <c>CDEFINE</c>.
-Also, gcc has to know what code it should produce, therefore <c>-m32</c> or <c>-m64</c>
-must be appended to CFLAGS. This is done via <c>profile.bashrc</c>. All you need to do
-if you want to build a package 32bit is to set <c>ABI=x86</c>.
-</p>
-
-<p>
-The details are shown in <c>make.defaults</c>:
-</p>
-
-<codesample lang="ebuild">
-MULTILIB_ABIS="x86 amd64"
-DEFAULT_ABI="amd64"
-
-CFLAGS_amd64="-m64"
-LDFLAGS_amd64="-m elf_x86_64"
-CHOST_amd64="x86_64-pc-linux-gnu"
-CDEFINE_amd64="__x86_64__"
-LIBDIR_amd64="lib64"
-
-CFLAGS_x86="-m32 -L/emul/linux/x86/lib -L/emul/linux/x86/usr/lib"
-LDFLAGS_x86="-m elf_i386 -L/emul/linux/x86/lib -L/emul/linux/x86/usr/lib"
-CHOST_x86="i686-pc-linux-gnu"
-CDEFINE_x86="__i386__"
-LIBDIR_x86="lib32"
-</codesample>
-
-</body>
-</subsection>
-
-</body>
-</section>
-
-<section>
-<title>Porting Notes</title>
-<body>
-
-<subsection>
-<title>Machine Word sizes</title>
-<body>
-
-<p>
-On AMD64, some types differ in size from x86:
-</p>
-
-<table>
-  <tr>
-    <th>
-      Type
-    </th>
-    <th>
-      x86 (ILP32)
-    </th>
-    <th>
-      amd64 (LP64)
-    </th>
-  </tr>
-  <tr>
-    <ti>
-      <c>char</c>
-    </ti>
-    <ti>
-      1 byte
-    </ti>
-    <ti>
-      1 byte
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>short</c>
-    </ti>
-    <ti>
-      2 bytes
-    </ti>
-    <ti>
-      2 bytes
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>int</c>
-    </ti>
-    <ti>
-      4 bytes
-    </ti>
-    <ti>
-      4 bytes
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>long</c>
-    </ti>
-    <ti>
-      <b>4 bytes</b>
-    </ti>
-    <ti>
-      <b>8 bytes</b>
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>long long</c>
-    </ti>
-    <ti>
-      8 bytes
-    </ti>
-    <ti>
-      8 bytes
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>pointer</c>
-    </ti>
-    <ti>
-      <b>4 bytes</b>
-    </ti>
-    <ti>
-      <b>8 bytes</b>
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>float</c>
-    </ti>
-    <ti>
-      4 bytes
-    </ti>
-    <ti>
-      4 bytes
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>double</c>
-    </ti>
-    <ti>
-      8 bytes
-    </ti>
-    <ti>
-      8 bytes
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>long double</c>
-    </ti>
-    <ti>
-      16 bytes
-    </ti>
-    <ti>
-      16 bytes
-    </ti>
-  </tr>
-</table>
-
-<p>
-If you need an exact amount of space, don't use these types but the <c>uXX</c> and
-<c>sXX</c> ones provided by <c>types.h</c>, where XX is the number of bits you need.
-Switching to a type that is the same on both arches is not suggested since it's
-not a clean solution and might cause problems with other arches.
-</p>
-
-</body>
-</subsection>
-
-<subsection>
-<title>Casts</title>
-<body>
-
-<p>
-Many upstream developers assume that the length of a pointer is 4 bytes, which
-can cause problems when programs do casts from <c>void *</c> to <c>int</c> and vice
-versa. With GCC 3.4, this causes warnings, the compilation won't abort. If
-you're lucky, your package works, but it's likely that you encounter
-segmentation faults or strange behaviour. GCC 4.0 refuses to compile such code.
-</p>
-
-</body>
-</subsection>
-
-</body>
-</section>
-
-<section>
-<title>Other Resources</title>
-<body>
-
-<ul>
-  <li>
-    <uri link="http://amd64.gentoo.org/">Gentoo/AMD64 Project</uri>
-  </li>
-  <li>
-    <uri link="http://www.gentoo.org/doc/en/gentoo-amd64-faq.xml">Gentoo/Linux AMD64 FAQ</uri>
-  </li>
-  <li>
-    <uri link="http://forums.gentoo.org/viewforum-f-46.html">Gentoo on AMD64 Forum</uri>
-  </li>
-</ul>
-
-</body>
-</section>
-
-</body>
-</chapter>
-</guide>
diff --git a/archs/mips/text.xml b/archs/mips/text.xml
deleted file mode 100644 (file)
index ca30269..0000000
+++ /dev/null
@@ -1,139 +0,0 @@
-<?xml version="1.0"?>
-<guide self="archs/mips/">
-<chapter>
-<title>Arch Specific Notes -- MIPS</title>
-<body>
-
-<p>
-The MIPS port uses the <c>mips</c> keyword. It focuses upon commonly available
-hardware <d/> mainly SGI and Cobalt systems <d/> although various embedded and
-special purpose boards are also supported.
-</p>
-
-<p>
-The <c>mips</c> keyword covers a huge range of architectures, CPUs and hardware,
-from tiny embedded devices up to server class kit with many tens of CPUs.
-</p>
-
-<note>
-Terminology:
-ABI stands for "Application Binary Interface". It refers to issues like
-calling conventions (which registers are used for passing parameters when
-calling functions) and the size of data types. ISA stands for "Instruction
-Set Architecture", and refers to the instructions available and the number
-and types of registers for a given CPU.
-</note>
-
-<section>
-<title>MIPS ABIs</title>
-<body>
-
-<p>
-The <c>o32</c> ABI was a wonderful invention by SGI that was good at the time, but
-later turned out to be a little bit short-sighted and inefficient. The <c>n32</c>
-ABI corrects that problem by pretending to be 32 bit, whilst in reality being 64
-bit. <c>n64</c> is another 64 bit ABI, this time not pretending to be 32 bit, which
-is therefore large, fat and yet very powerful.
-</p>
-
-<p>
-All of these ABIs can be both big and little endian, since MIPS CPUs come in
-both flavours, although most hardware does not support both options.
-</p>
-
-<p>
-All of these ABIs are popular amongst various applications domains. None of them
-actually work correctly.
-</p>
-
-</body>
-</section>
-
-<section>
-<title>MIPS ISAs</title>
-<body>
-
-<p>
-The most commonly seen MIPS ISAs are mips2, mips3, mips4, mips32 and mips64. If
-you encounter a situation in which you need to know about the differences
-between these, talk to the MIPS team.
-</p>
-
-</body>
-</section>
-
-<section>
-<title>Not Dropping <c>CFLAGS</c> on MIPS</title>
-<body>
-
-<p>
-Because <c>CFLAGS</c> are sometimes used to specify ISA and ABI information, it is
-vital that packages honour this setting. See
-<uri link="::general-concepts/user-environment/#Not Filtering Variables"/>.
-</p>
-
-</body>
-</section>
-
-<section>
-<title>Additional MIPS Keywording Requirements</title>
-<body>
-
-<note>
-This section is in addition to the guidelines in <uri link="::keywording/" /> It
-discusses <e>additional</e> requirements for the MIPS architectures.
-</note>
-
-<p>
-For a package to have the <c>~mips</c> keyword added, the following additional
-items must generally hold:
-</p>
-
-<ul>
-  <li>
-    The package should work on both big and little endian systems, on both pure
-    32 bit and pure 64 bit systems and on systems with differing kernel and
-    userland ABIs.
-  </li>
-</ul>
-
-<p>
-It is generally expected that anyone who does keywording for MIPS should be on
-the <c>mips@</c> alias.
-</p>
-
-<p>
-MIPS doesn't currently use stable keywords so don't file stable requests to them.
-</p>
-</body>
-</section>
-
-<section>
-<title>Contacting the MIPS Team</title>
-<body>
-
-<p>
-The MIPS team can be contacted:
-</p>
-
-<ul>
-  <li>
-    Via Bugzilla bugs assigned to <c>mips@</c>
-  </li>
-  <li>
-    Via email to the <c>mips@</c> email alias
-  </li>
-  <li>
-    Via email to the <c>gentoo-mips</c> mailing list
-  </li>
-  <li>
-    Via the <c>#gentoo-mips</c> IRC channel on Freenode
-  </li>
-</ul>
-
-</body>
-</section>
-
-</body>
-</chapter>
-</guide>
diff --git a/archs/ppc/text.xml b/archs/ppc/text.xml
deleted file mode 100644 (file)
index 6313f81..0000000
+++ /dev/null
@@ -1,107 +0,0 @@
-<?xml version="1.0"?>
-<guide self="archs/ppc/">
-<chapter>
-<title>Arch Specific Notes -- PPC</title>
-<body>
-
-<p>
-The Gentoo PowerPC port uses the <c>ppc</c> keyword and maintains compatibility with
-all 32 bit PowerPC processors.  It is also used for 32 bit userland installs
-on 64 bit PowerPC systems.
-</p>
-
-<section>
-<title>Common issues</title>
-<body>
-
-<p>
-Although PowerPC processors can be run in little endian mode, the Linux kernel
-runs on PowerPC processors in big endian mode.  Due to this fact, a common
-PowerPC issue is dealing with code that is written with only little endian
-processors in mind (<c>x86</c>/<c>amd64</c>).  These bugs can be difficult to find, but are
-usually found when loading data from disk (such as a structure written directly
-to disk) or during bit operations.
-</p>
-
-<p>
-The PowerPC port of gcc uses unsigned characters by default, which is
-different than on <c>x86</c>.  If the code you are working with assumes that the <c>char</c>
-type is signed, you can pass <c>-fsigned-char</c> to <c>GCC</c> to work around the issue.
-</p>
-
-</body>
-</section>
-
-<section>
-<title>Altivec</title>
-<body>
-
-<p>
-Altivec (Apple's name for VMX SIMD instructions) is supported on the <c>G4</c> and <c>G5</c>
-processors.  You can enable support for the instruction set by passing
-<c>-mabi=altivec -maltivec</c> to <c>GCC</c>.  Note that passing <c>-mcpu=</c> options may enable
-altivec without passing the flags above.
-</p>
-
-<p>
-Occasionally, an altivec issue that crops up is that Apple uses a different
-notation for indicating vectors, (x) instead of {x}.  Using something like the
-code below to define vectors is the preferred way of fixing this:
-</p>
-
-<codesample lang="c">
-#ifdef CONFIG_APPLE
-#define AVV(x...) (x)
-#else
-#define AVV(x...) {x}
-#endif
-</codesample>
-
-</body>
-</section>
-
-<section>
-<title>Contacting the PowerPC Team</title>
-<body>
-
-<p>
-The PowerPC team can be reached by:
-</p>
-
-<ul>
-  <li>
-    Via the <c>#gentoo-ppc</c> IRC channel on freenode
-  </li>
-  <li>
-    Via email to <c>ppc@gentoo.org</c>
-  </li>
-  <li>
-    Via email to <c>gentoo-ppc-dev@gentoo.org</c> the mailing list
-  </li>
-  <li>
-    Via Bugzilla bugs assigned to <c>ppc@gentoo.org</c>
-  </li>
-</ul>
-
-</body>
-</section>
-
-<section>
-<title>Other Resources</title>
-<body>
-
-<ul>
-  <li>
-    <uri link="http://www.gentoo.org/doc/en/gentoo-ppc-faq.xml">Gentoo PPC FAQ</uri>
-  </li>
-  <li>
-    <uri link="http://forums.gentoo.org/viewforum-f-24.html">Gentoo PPC Forums</uri>
-  </li>
-</ul>
-
-</body>
-</section>
-
-</body>
-</chapter>
-</guide>
diff --git a/archs/sparc/text.xml b/archs/sparc/text.xml
deleted file mode 100644 (file)
index f514c86..0000000
+++ /dev/null
@@ -1,141 +0,0 @@
-<?xml version="1.0"?>
-<guide self="archs/sparc/">
-<chapter>
-<title>Arch Specific Notes -- SPARC</title>
-<body>
-
-<p>
-The SPARC port uses the <c>sparc</c> keyword. It focuses on <c>sun4u</c>
-hardware (Sun UltraSparc systems with <c>v9</c> CPUs). <c>v8</c> processors
-and 2.4 kernels should still work with Gentoo, but they are no longer supported
-by the Gentoo/SPARC team.
-</p>
-
-<section>
-<title>SPARC Kernel and Userland ABIs</title>
-<body>
-
-<p>
-<c>v9</c> systems use a pure 64 bit kernel and a pure 32 bit userland. This can
-cause portability problems when working with low level software if the kernel
-does not provide working 32 bit compatibility interfaces.
-</p>
-
-<p>
-<c>v8</c> systems use a pure 32 bit kernel and a pure 32 bit userland.
-</p>
-
-<p>
-All of the above SPARC systems are big endian, nevertheless the <c>v9</c>
-architecture also utilizes little-endian instructions to access data on PCI
-buses.
-</p>
-
-</body>
-</section>
-
-<section>
-<title>Additional SPARC Keywording Requirements</title>
-<body>
-
-<note>
-This section is in addition to the guidelines in
-<uri link="::keywording#Keywording on Upgrades"/>. It discusses <e>additional</e>
-requirements for the SPARC architecture.
-</note>
-
-<p>
-For a package to have the <c>~sparc</c> keyword added, the following additional
-items must generally hold:
-</p>
-
-<ul>
-  <li>
-    The package must have been tested by an arch team member (or someone with
-    permission from the arch team) on a <c>v9</c> system.
-  </li>
-</ul>
-
-<p>
-It is generally expected that anyone who does keywording for SPARC should be on
-the <c>sparc@</c> alias.
-</p>
-
-</body>
-</section>
-
-<section>
-<title>SPARC Instruction Set and Performance Notes</title>
-<body>
-
-<p>
-There are three basic SPARC instruction set standards.
-</p>
-
-<ul>
-  <li>
-    <c>v7</c> is the original instruction set used in very old hardware. Gentoo does
-    not ship <c>v7</c> capable stages, however a sufficiently crazy person could in
-    theory run Gentoo on a <c>v7</c> machine.
-  </li>
-  <li>
-    <c>v8</c> is an extension of <c>v7</c> with added support for hardware integer
-    multiplication and division. Last time Gentoo sparc32 (<c>sun4m</c>) stages
-    were available was on 2006.1 release.
-  </li>
-  <li>
-    <c>v9</c> adds in 64 bit support and a large number of performance-enhancing
-    features. Gentoo sparc64 (<c>sun4u</c>) stages are <c>v9</c>.
-  </li>
-</ul>
-
-<p>
-In addition, individual CPU implementations have slight differences <d/> for
-example, HyperSparc CPUs have relaxed requirements when it comes to scheduling
-certain instructions. These are relatively minor differences.
-</p>
-
-<p>
-If <c>gcc</c> is invoked without any <c>-mcpu</c> parameter, it will generate <c>v7</c>
-code. Depending upon the application, this can be anywhere up to five times
-slower than <c>v9</c> code when running on an UltraSparc <d/> cryptographic and
-graphics applications which make heavy use of integer multiplication and
-division are especially badly hit. For this reason, the comments in
-<uri link="::general-concepts/user-environment#Not Filtering Variables"/>
-are especially important on SPARC.
-</p>
-
-</body>
-</section>
-
-<section>
-<title>Contacting the SPARC Team</title>
-<body>
-
-<p>
-The SPARC team can be contacted:
-</p>
-
-<ul>
-  <li>
-    Via Bugzilla bugs assigned to <c>sparc@</c>
-  </li>
-  <li>
-    Via email to the <c>sparc@</c> email alias
-  </li>
-  <li>
-    Via email to the <c>gentoo-sparc</c> mailing list
-  </li>
-  <li>
-    Via the <c>#gentoo-sparc</c> IRC channel on Freenode
-  </li>
-</ul>
-
-</body>
-</section>
-
-</body>
-</chapter>
-</guide>
-
-
diff --git a/archs/text.xml b/archs/text.xml
deleted file mode 100644 (file)
index 4eb9750..0000000
+++ /dev/null
@@ -1,37 +0,0 @@
-<?xml version="1.0"?>
-<guide self="archs/">
-<chapter>
-<title>Arch Specific Notes</title>
-<body>
-
-<p>
-This section provides a brief overview of various arch-specific issues. It is not
-complete, and it is not a substitute for discussing any problems with the
-relevant arch team.
-</p>
-
-<note>
-People who have worked with some other distributions may find Gentoo's
-views on architecture support slightly unfamiliar. We do not follow Debian's
-attempts to provide a standard set of packages at specific versions and install
-it onto every platform <d/> rather, we simply attempt to provide whatever
-happens to work best in any situation.
-</note>
-</body>
-
-<section>
-<title>Contents</title>
-<body>
-<contentsTree/>
-</body>
-</section>
-</chapter>
-
-<include href="alpha/"/>
-<include href="amd64/"/>
-<include href="mips/"/>
-<include href="ppc/"/>
-<include href="sparc/"/>
-<include href="x86/"/>
-
-</guide>
diff --git a/archs/x86/text.xml b/archs/x86/text.xml
deleted file mode 100644 (file)
index e0b7894..0000000
+++ /dev/null
@@ -1,73 +0,0 @@
-<?xml version="1.0"?>
-<guide self="archs/x86/">
-<chapter>
-<title>Arch Specific Notes -- x86</title>
-<body>
-
-<p>
-Originally it was assumed that all developers had access to x86 hardware,
-so there was no arch team created for x86. This is no longer the case, and
-x86 is to be treated like any other arch with regards to moving a package to
-stable.
-</p>
-
-<p>
-If you want your application to be moved to stable on x86, please
-contact the x86 team. If your package requires specific hardware, or a specific
-non-trivial setup to test, then we will probably allow you to mark it stable,
-unless someone on the team can test it.
-</p>
-
-<section>
-<title>x86 Team Guidelines</title>
-<body>
-
-<p>
-The following is a list of rules and expectations for members of the x86 team:
-</p>
-
-<ul>
-  <li>
-    Assist/resolve 4 bugs a month that are assigned to the team
-  </li>
-  <li>
-    Be present in our IRC channel, <c>#gentoo-x86/irc.freenode.net</c>
-  </li>
-  <li>
-    If you need one of your packages stable, file a bug to the team.  You are not
-    exempt from the same rules everyone else must follow.
-  </li>
-  <li>
-    Take part in discussions on bugs or the alias when team members ask for input
-  </li>
-</ul>
-
-</body>
-</section>
-
-<section>
-<title>Contacting the x86 Team</title>
-<body>
-
-<p>
-The x86 team can be contacted:
-</p>
-
-<ul>
-  <li>
-    Via Bugzilla bugs assigned to <c>x86@</c>
-  </li>
-  <li>
-    Via email to the <c>x86@</c> email alias
-  </li>
-  <li>
-    Via the <c>#gentoo-x86</c> IRC channel on Freenode
-  </li>
-</ul>
-
-</body>
-</section>
-
-</body>
-</chapter>
-</guide>
diff --git a/devbook.xsl b/devbook.xsl
deleted file mode 100644 (file)
index 0548c22..0000000
+++ /dev/null
@@ -1,651 +0,0 @@
-<xsl:stylesheet version='1.0' xmlns:xsl='http://www.w3.org/1999/XSL/Transform'
-  xmlns:str="http://exslt.org/strings"
-  xmlns:exslt="http://exslt.org/common"
-  extension-element-prefixes="str exslt xsl"
-  exclude-result-prefixes="str exslt xsl"
-  xmlns="http://www.w3.org/1999/xhtml">
-
-<xsl:import href="xsl/str.tokenize.function.xsl"/>
-<xsl:import href="xsl/lang.highlight.c.xsl"/>
-<xsl:import href="xsl/lang.highlight.ebuild.xsl"/>
-<xsl:import href="xsl/lang.highlight.make.xsl"/>
-<xsl:import href="xsl/lang.highlight.m4.xsl"/>
-<xsl:import href="xsl/lang.highlight.sgml.xsl"/>
-
-<xsl:output method="xml" doctype-system="http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd" 
-           doctype-public="-//W3C//DTD XHTML 1.0 Strict//EN" indent="yes"/>
-
-<xsl:variable name="newline">
-<xsl:text>
-</xsl:text>
-</xsl:variable>
-
-  <xsl:template match="chapter">
-    <h1><xsl:apply-templates select="title"/></h1>
-    <xsl:apply-templates select="(body|section)"/>
-  </xsl:template>
-
-  <xsl:template match="section">
-    <div class="section">
-      <xsl:variable name="anchor">
-        <xsl:call-template name="convert-to-anchor">
-          <xsl:with-param name="data" select="title"/>
-        </xsl:call-template>
-      </xsl:variable>
-
-      <h2><a name="{$anchor}"><xsl:apply-templates select="title"/></a></h2>
-      <xsl:apply-templates select="(body|subsection)"/>
-    </div>
-  </xsl:template>
-
-  <xsl:template match="subsection">
-    <div class="section">
-      <xsl:variable name="anchor">
-        <xsl:call-template name="convert-to-anchor">
-          <xsl:with-param name="data" select="title"/>
-        </xsl:call-template>
-      </xsl:variable>
-
-      <h3><a name="{$anchor}"><xsl:apply-templates select="title"/></a></h3>
-      <xsl:apply-templates select="(body|subsubsection)"/>
-
-      <!-- If you need, change here to add more nesting levels -->
-    </div>
-  </xsl:template>
-
-  <xsl:template match="subsubsection">
-    <div class="section">
-      <xsl:variable name="anchor">
-        <xsl:call-template name="convert-to-anchor">
-          <xsl:with-param name="data" select="title"/>
-        </xsl:call-template>
-      </xsl:variable>
-
-      <h4><a name="{$anchor}"><xsl:apply-templates select="title"/></a></h4>
-      <xsl:apply-templates select="(body)"/>
-
-      <!-- If you need, change here to add more nesting levels -->
-    </div>
-  </xsl:template>
-
-  <xsl:template match="body">
-    <xsl:apply-templates/>
-  </xsl:template>
-
-  <xsl:template match="p">
-    <p>
-    <xsl:apply-templates/>
-    </p>
-  </xsl:template>
-
-  <xsl:template match="pre">
-  <pre><xsl:apply-templates/></pre>
-  </xsl:template>
-
-  <!-- Tables -->
-  <!-- From the Gentoo GuideXML Stylesheet -->
-  <xsl:template match="table">
-  <table><xsl:apply-templates/></table>
-  </xsl:template>
-
-  <xsl:template match="tr">
-  <tr><xsl:apply-templates/></tr>
-  </xsl:template>
-
-  <xsl:template match="tcolumn">
-  <col width="{@width}"/>
-  </xsl:template>
-
-  <!-- Table Item -->
-  <xsl:template match="ti">
-    <td class="devbook">
-      <xsl:if test="@colspan">
-       <xsl:attribute name="colspan"><xsl:value-of select="@colspan"/></xsl:attribute>
-      </xsl:if>
-      <xsl:if test="@rowspan">
-       <xsl:attribute name="rowspan"><xsl:value-of select="@rowspan"/></xsl:attribute>
-      </xsl:if>
-      <xsl:apply-templates/>
-    </td>
-  </xsl:template>
-
-  <!-- Table Heading -->
-  <xsl:template match="th">
-    <td class="devbook">
-      <xsl:if test="@colspan">
-       <xsl:attribute name="colspan"><xsl:value-of select="@colspan"/></xsl:attribute>
-       <!-- Center only when item spans several columns as
-             centering all <th> might disrupt some pages.
-             We might want to use a plain html <th> tag later.
-             Tip: to center a single-cell title, use <th colspan="1">
-         -->
-       <xsl:attribute name="style">text-align:center</xsl:attribute>
-      </xsl:if>
-      <xsl:if test="@rowspan">
-       <xsl:attribute name="rowspan"><xsl:value-of select="@rowspan"/></xsl:attribute>
-      </xsl:if>
-      <b>
-       <xsl:apply-templates/>
-      </b>
-    </td>
-  </xsl:template>
-  <!-- End Table Jojo -->
-
-  <!-- FIXME: Handle lang=... -->
-  <xsl:template match="codesample">
-      <xsl:variable name="ctype"><xsl:if test="@lang = 'ebuild'">Constant</xsl:if></xsl:variable>
-      <xsl:variable name="numbering" select="@numbering"/>
-      <xsl:variable name="lang" select="@lang"/>
-      <pre><span class="{$ctype}">
-
-      <xsl:for-each select="str:tokenize_plasmaroo(., $newline)">
-        <xsl:choose>
-          <xsl:when test=". = $newline">
-            <xsl:if test="position() != 1"><xsl:value-of select='$newline'/></xsl:if>
-            <xsl:if test="$numbering = 'lines' and position() != last()-1">
-              <span style="float: left;"><xsl:number format="01"/>:<xsl:text> </xsl:text></span>
-            </xsl:if>
-          </xsl:when>
-          <xsl:otherwise>
-            <xsl:choose>
-              <xsl:when test="$lang = 'ebuild'">
-                <xsl:call-template name="lang.highlight.ebuild.tokenate">
-                  <xsl:with-param name="data" select="."/>
-                </xsl:call-template>               
-              </xsl:when>
-              <xsl:when test="$lang = 'make'">
-                <xsl:call-template name="lang.highlight.make.tokenate">
-                  <xsl:with-param name="data" select="."/>
-                </xsl:call-template>               
-              </xsl:when>
-              <xsl:when test="$lang = 'm4'">
-                <xsl:call-template name="lang.highlight.m4.tokenate">
-                  <xsl:with-param name="data" select="."/>
-                </xsl:call-template>               
-              </xsl:when>
-              <xsl:when test="$lang = 'sgml'">
-                <xsl:call-template name="lang.highlight.sgml.tokenate">
-                  <xsl:with-param name="data" select="."/>
-                </xsl:call-template>               
-              </xsl:when>
-              <xsl:when test="$lang = 'c'">
-                <xsl:call-template name="lang.highlight.c.tokenate">
-                  <xsl:with-param name="data" select="."/>
-                </xsl:call-template>               
-              </xsl:when>
-              <xsl:otherwise>
-                <xsl:message>Error: Unknown language type (<xsl:value-of select="$lang"/>)</xsl:message>
-                <xsl:value-of select="."/>
-              </xsl:otherwise>
-            </xsl:choose>
-          </xsl:otherwise>
-        </xsl:choose>
-      </xsl:for-each>
-      </span></pre>
-  </xsl:template>
-
-  <xsl:template match="figure">
-    <div class="figure">
-      <div class="image"><img alt="{@short}" src="{@link}"/></div>
-      <p class="caption"><xsl:value-of select="."/></p>
-    </div>
-  </xsl:template>
-
-  <!-- Lists -->
-  <xsl:template match="li">
-    <li><xsl:apply-templates/></li>
-  </xsl:template>
-
-  <xsl:template match="ol">
-    <ol><xsl:apply-templates/></ol>
-  </xsl:template>
-
-  <xsl:template match="ul">
-    <ul><xsl:apply-templates/></ul>
-  </xsl:template>
-
-  <!-- Definition Lists -->
-  <xsl:template match="dl">
-    <dl><xsl:apply-templates/></dl>
-  </xsl:template>
-
-  <xsl:template match="dt">
-    <dt><xsl:apply-templates/></dt>
-  </xsl:template>
-
-  <xsl:template match="dd">
-    <dd>
-      <xsl:for-each select="p">
-        <xsl:choose>
-        <xsl:when test="count(../p) = 1"><xsl:apply-templates/></xsl:when>
-        <xsl:when test="position() = 1"><p class="first"><xsl:apply-templates/></p></xsl:when>
-        <xsl:when test="position() = last()"><p class="last"><xsl:apply-templates/></p></xsl:when>
-        <xsl:otherwise><p><xsl:apply-templates/></p></xsl:otherwise>
-        </xsl:choose>
-      </xsl:for-each>
-    </dd>
-  </xsl:template>
-
-  <xsl:template match="important">
-    <div class="important">
-    <p class="first admonition-title">Important</p>
-    <p class="last"><xsl:apply-templates/></p>
-    </div>
-  </xsl:template>
-
-  <xsl:template match="note">
-    <div class="note">
-    <p class="first admonition-title">Note</p>
-    <p class="last"><xsl:apply-templates/></p>
-    </div>
-  </xsl:template>
-
-  <xsl:template match="todo">
-    <div class="todo">
-    <p class="first admonition-title">Todo</p>
-    <p class="last"><xsl:apply-templates/></p>
-    </div>
-  </xsl:template>
-
-  <xsl:template match="warning">
-    <div class="warning">
-    <p class="first admonition-title">Warning</p>
-    <p class="last"><xsl:apply-templates/></p>
-    </div>
-  </xsl:template>
-
-  <xsl:template match="b">
-    <b><xsl:apply-templates/></b>
-  </xsl:template>
-
-  <xsl:template match="d">
-    &#8212;
-  </xsl:template>
-
-  <xsl:template match="e">
-    <i><xsl:apply-templates/></i>
-  </xsl:template>
-
-  <xsl:template match="c">
-    <code class="docutils literal"><span class="pre"><xsl:apply-templates/></span></code>
-  </xsl:template>
-
-  <xsl:template name="convert-to-anchor">
-    <xsl:param name="data"/>
-    <xsl:variable name="lcletters">abcdefghijklmnopqrstuvwxyz--</xsl:variable>
-    <xsl:variable name="ucletters">ABCDEFGHIJKLMNOPQRSTUVWXYZ<xsl:text> </xsl:text>,</xsl:variable>
-    <xsl:value-of select="translate($data,$ucletters,$lcletters)"/>
-  </xsl:template>
-
-  <xsl:template match="uri">
-    <xsl:choose>
-      <xsl:when test="starts-with(@link, '::')">
-      <!-- Ideally we would work out how many levels to nest down to save a few bytes but
-           going down to root level works just as well (and is faster). -->
-        <xsl:variable name="relative_path_depth" select="string-length(/guide/@self)-string-length(translate(/guide/@self, '/' , ''))"/>
-        <xsl:variable name="relative_path_depth_recursion">
-          <xsl:call-template name="str:repeatString">
-            <xsl:with-param name="count" select="$relative_path_depth"/>
-            <xsl:with-param name="append">../</xsl:with-param>
-         </xsl:call-template>
-       </xsl:variable>
-        <xsl:choose>
-          <xsl:when test="contains(@link, '##')">
-            <a href="{concat($relative_path_depth_recursion, substring-after(substring-before(@link, '##'), '::'), '/index.html#', substring-after(@link, '##'))}"><xsl:value-of select="."/></a>
-          </xsl:when>
-          <xsl:when test="contains(@link, '#')">
-            <xsl:variable name="anchor">
-              <xsl:call-template name="convert-to-anchor">
-                <xsl:with-param name="data" select="substring-after(@link, '#')"/>
-              </xsl:call-template>
-            </xsl:variable>
-            <xsl:variable name="slash">
-              <xsl:if test="substring(substring-before(@link, '#'), string-length(substring-before(@link, '#'))) != '/'">/</xsl:if>
-            </xsl:variable>
-            <xsl:choose>
-              <xsl:when test=". != ''">
-                <a href="{concat($relative_path_depth_recursion, substring-after(substring-before(@link, '#'), '::'), $slash, 'index.html#', $anchor)}"><xsl:value-of select="."/></a>
-              </xsl:when>
-              <xsl:otherwise>
-                <a href="{concat($relative_path_depth_recursion, substring-after(substring-before(@link, '#'), '::'), $slash, 'index.html#', $anchor)}"><xsl:value-of select="substring-after(@link, '#')"/></a>
-              </xsl:otherwise>
-            </xsl:choose>
-          </xsl:when>
-          <xsl:otherwise>
-            <xsl:variable name="slash">
-              <xsl:if test="substring(@link, string-length(@link)) != '/'">/</xsl:if>
-            </xsl:variable>
-            <xsl:choose>
-              <xsl:when test=". != ''">
-                <a href="{concat($relative_path_depth_recursion, substring-after(@link, '::'), $slash, 'index.html')}"><xsl:value-of select="."/></a>
-              </xsl:when>
-              <xsl:otherwise>
-                <a href="{concat($relative_path_depth_recursion, substring-after(@link, '::'), $slash, 'index.html')}"><xsl:value-of select="document(concat(/guide/@self, $relative_path_depth_recursion, substring-after(@link, '::'), '/text.xml'))/guide/chapter[1]/title"/></a>
-              </xsl:otherwise>
-            </xsl:choose>
-          </xsl:otherwise>
-        </xsl:choose>
-      </xsl:when>
-      <xsl:otherwise>
-        <a href="{@link}"><xsl:value-of select="."/></a>
-      </xsl:otherwise>
-    </xsl:choose>
-  </xsl:template>
-
-  <!-- TOC Tree -->
-  <xsl:template match="contentsTree" name="contentsTree">
-    <xsl:param name="depth" select="0"/>
-    <xsl:param name="maxdepth">
-      <xsl:choose>
-       <xsl:when test="@maxdepth"><xsl:value-of select="@maxdepth"/></xsl:when>
-       <xsl:otherwise>0</xsl:otherwise>
-      </xsl:choose>
-    </xsl:param>
-    <xsl:param name="path">
-      <xsl:choose>
-        <xsl:when test="@root"><xsl:value-of select="@root"/></xsl:when>
-        <xsl:otherwise><xsl:value-of select="/guide/@self"/></xsl:otherwise>
-      </xsl:choose>
-    </xsl:param>
-    <xsl:param name="path_rel">
-      <xsl:if test="$depth = 0 and $path = '' and /guide/@self != ''">
-        <xsl:call-template name="str:repeatString">
-          <xsl:with-param name="count" select="string-length(/guide/@self)-string-length(translate(/guide/@self, '/' , ''))"/>
-          <xsl:with-param name="append">../</xsl:with-param>
-       </xsl:call-template>
-      </xsl:if>
-    </xsl:param>
-    <xsl:param name="extraction" select="@extraction"/>
-    <xsl:param name="extraction_counting"/>
-
-    <xsl:variable name="doc_self" select="concat($path, 'text.xml')"/>
-    <xsl:if test="count(document($doc_self)/guide/include) &gt; 0 and ($depth &lt; $maxdepth or $maxdepth = '0')">
-    <xsl:choose>
-      <xsl:when test="$extraction_counting = 1">
-       <xsl:for-each select="document($doc_self)/guide/include">
-         <count value="{count(document(concat($path, @href, 'text.xml'))//*[name()=$extraction])}" path="{concat($path, @href)}">
-           <xsl:call-template name="contentsTree">
-             <xsl:with-param name="depth" select="$depth + 1"/>
-             <xsl:with-param name="maxdepth" select="$maxdepth"/>
-             <xsl:with-param name="path" select="concat($path, @href)"/>
-             <xsl:with-param name="path_rel" select="concat($path_rel, @href)"/>
-             <xsl:with-param name="extraction" select="$extraction"/>
-             <xsl:with-param name="extraction_counting" select="1"/>
-           </xsl:call-template>
-         </count>
-       </xsl:for-each>
-      </xsl:when>
-      <xsl:otherwise>
-       <ul>
-         <xsl:for-each select="document($doc_self)/guide/include">
-           <xsl:variable name="extraction_counter_node">
-             <xsl:call-template name="contentsTree">
-               <xsl:with-param name="depth" select="$depth + 1"/>
-               <xsl:with-param name="maxdepth" select="$maxdepth"/>
-               <xsl:with-param name="path" select="concat($path, @href)"/>
-               <xsl:with-param name="path_rel" select="concat($path_rel, @href)"/>
-               <xsl:with-param name="extraction" select="$extraction"/>
-               <xsl:with-param name="extraction_counting" select="1"/>
-             </xsl:call-template>
-           </xsl:variable>
-           <xsl:variable name="extraction_counter" select="count(exslt:node-set($extraction_counter_node)//*[@value != 0]) + count(document(concat($path, @href, 'text.xml'))//*[name()=$extraction])"/>
-           <xsl:if test="string($extraction) = '' or $extraction_counter > 0">
-           <li>
-             <a class="reference" href="{concat($path_rel, @href, 'index.html')}"><xsl:value-of select="document(concat($path, @href, 'text.xml'))/guide/chapter[1]/title"/></a>
-             <xsl:if test="$extraction != ''">
-                <ul>
-                <xsl:for-each select="document(concat($path, @href, 'text.xml'))//*[name()=$extraction]">
-                  <xsl:variable name="extraction_id" select="position()"/>
-                  <li><xsl:apply-templates select="(//*[name()=$extraction])[position()=$extraction_id]"/><br/></li>
-                </xsl:for-each>
-                </ul>
-              </xsl:if>
-             <xsl:call-template name="contentsTree">
-               <xsl:with-param name="depth" select="$depth + 1"/>
-               <xsl:with-param name="maxdepth" select="$maxdepth"/>
-               <xsl:with-param name="path" select="concat($path, @href)"/>
-               <xsl:with-param name="path_rel" select="concat($path_rel, @href)"/>
-               <xsl:with-param name="extraction" select="$extraction"/>
-             </xsl:call-template>
-           </li>
-           </xsl:if>
-         </xsl:for-each>
-       </ul>
-      </xsl:otherwise>
-    </xsl:choose>
-    </xsl:if>
-  </xsl:template>
-
-  <xsl:template match="/">
-    <html lang="en-GB" xml:lang="en-GB" xmlns="http://www.w3.org/1999/xhtml">
-    <head>
-        <title>Gentoo Development Guide: <xsl:value-of select="/guide/chapter[1]/title"/></title>
-        <xsl:variable name="relative_path_depth" select="string-length(/guide/@self)-string-length(translate(/guide/@self, '/' , ''))"/>
-        <xsl:variable name="relative_path_depth_recursion">
-          <xsl:call-template name="str:repeatString">
-            <xsl:with-param name="count" select="$relative_path_depth"/>
-            <xsl:with-param name="append">../</xsl:with-param>
-          </xsl:call-template>
-        </xsl:variable>        
-        <link rel="stylesheet" href="{$relative_path_depth_recursion}devmanual.css" type="text/css" />
-    </head>
-    <body>
-      <div class="main">
-       <h1>Gentoo Development Guide</h1>
-       <div class="navtop" style="text-align: center;">
-         <table style="border-top: 1px dashed #330066; margin-left: auto; margin-right: auto;
-                       width: 100%;">
-
-           <col width="33%" />
-           <col width="34%" />
-           <col width="33%" />
-           <tr>
-             <td style="text-align: center; border-right: 1px dashed #330066;">&#x2190; <xsl:call-template name="findPrevious"/></td>
-             <td style="text-align: center;">&#x2191; <xsl:call-template name="findParent"/> &#x2191;</td>
-             <td style="text-align: center; border-left: 1px dashed #330066;"><xsl:call-template name="findNext"/> &#x2192;</td>
-           </tr>
-         </table>
-       </div>
-
-       <div class="document">
-         <xsl:apply-templates/>
-       </div>
-
-       <div class="navbottom" style="text-align: center;">
-         <table style="border-top: 1px dashed #330066; margin-left: auto; margin-right: auto;
-                       width: 100%;">
-
-           <col width="33%" />
-           <col width="34%" />
-           <col width="33%" />
-           <tr>
-             <td style="text-align: center; border-right: 1px dashed #330066;">&#x2190; <xsl:call-template name="findPrevious"/></td>
-             <td style="text-align: center;">&#x2191; <xsl:call-template name="findParent"/> &#x2191;</td>
-             <td style="text-align: center; border-left: 1px dashed #330066;"><xsl:call-template name="findNext"/> &#x2192;</td>
-           </tr>
-         </table>
-       </div>
-      </div>
-
-      <div class="footer">
-       <p>
-           <a href="http://validator.w3.org/check/referer"><img src="/icons/icon_mini-xhtml.png" alt="Valid XHTML 1.0" /></a>
-           <a href="http://jigsaw.w3.org/css-validator/check/referer"><img src="/icons/icon_mini-css.png" alt="Valid CSS" /></a>
-           <a href="http://www.gentoo.org/"><img src="/icons/icon_mini-gentoo.png" alt="Powered by Gentoo" /></a>
-           <a href="http://creativecommons.org/licenses/by-sa/2.0/"><img src="/icons/icon_mini-creativecommons.png" alt="Creative Commons License" /></a>
-           <img src="/icons/icon_mini-xml.png" alt="XML Powered!"/>
-         <br />
-         <br />
-         The text of this document is distributed under the <a href="http://creativecommons.org/licenses/by-sa/2.0/">Creative Commons Attribution-ShareAlike 2.0 License</a>.
-       </p>
-      </div>
-    </body>
-    </html>
-  </xsl:template>
-
-  <xsl:template name="str:repeatString">
-    <xsl:param name="string"/>
-    <xsl:param name="count"/>
-    <xsl:param name="append"/>
-    <xsl:choose>
-    <xsl:when test="$count != 0">
-      <xsl:call-template name="str:repeatString">
-        <xsl:with-param name="string" select="concat($string, $append)"/>
-        <xsl:with-param name="count" select="$count - 1"/>
-        <xsl:with-param name="append" select="$append"/>
-      </xsl:call-template>
-    </xsl:when>
-    <xsl:otherwise>
-      <xsl:value-of select="$string"/>
-    </xsl:otherwise>
-    </xsl:choose>
-  </xsl:template>
-
-  <xsl:template name="findNext">
-    <xsl:param name="self" select="/guide/@self"/>
-    <xsl:choose>
-      <!-- To find the "next" node:
-          * See if this node includes any subnodes... if it does, that is
-            our next node
-          * Look at our parent and see if it includes any nodes after us, if
-            it does use it.
-          * Repeat recursively, going down parents if needed.
-           * End at the root item if needed.
-      -->
-      <xsl:when test="count(/guide/include) &gt; 0">
-       <xsl:variable name="doc" select="/guide/include[1]/@href"/>
-       <a href="{concat($doc, 'index.html')}"><xsl:value-of select="document(concat(/guide/@self, $doc, 'text.xml'))/guide/chapter[1]/title"/></a>
-      </xsl:when>
-      <xsl:otherwise>
-       <!-- This document's path -->
-       <xsl:variable name="doc_self" select="concat($self, 'text.xml')"/>
-       <!-- Turn the absolute path into a relative path so we can find ourselves in
-            the parent -->
-        <xsl:variable name="path_self" select="concat(str:tokenize($self, '/')[last()], '/')"/>
-       <xsl:variable name="index_self" select="count(document(concat($self, '../text.xml'))/guide/include[@href=$path_self]/preceding-sibling::*)+1"/>
-       <!-- Go down a parent, lookup the item after us... -->
-        <xsl:variable name="parentItem_lookup" select="document(concat($self, '../text.xml'))/guide/include[$index_self]/@href"/>
-       <xsl:variable name="parentItem_next" select="concat(document(concat($self, '../text.xml'))/guide/@self, $parentItem_lookup)"/>
-        <xsl:choose>
-         <!-- If we have an item after us, or we are at the root node (termination condition) we need to
-              not recurse any further... -->
-         <xsl:when test="$parentItem_lookup != '' or document(concat($self, '../text.xml'))/guide/@root">
-           <xsl:variable name="parentItem_actual">
-             <xsl:choose>
-               <xsl:when test="$parentItem_next = ''"></xsl:when>
-               <xsl:otherwise><xsl:value-of select="$parentItem_next"/></xsl:otherwise>
-             </xsl:choose>
-           </xsl:variable>
-           <!-- This is where we do a little trickery. To count how many levels we need to go down, 
-                 we count how far up we currently are (remember that the absolute link we get is relative to /...) and
-                hence we can build a relative link... -->
-           <xsl:variable name="relative_path" select="$parentItem_actual"/>
-           <xsl:variable name="relative_path_depth" select="string-length(/guide/@self)-string-length(translate(/guide/@self, '/' , ''))"/>
-           <xsl:variable name="relative_path_depth_recursion">
-             <xsl:call-template name="str:repeatString">
-                <xsl:with-param name="count" select="$relative_path_depth"/>
-                <xsl:with-param name="append">../</xsl:with-param>
-             </xsl:call-template>
-           </xsl:variable>
-           <a href="{concat($relative_path_depth_recursion, $relative_path, 'index.html')}"><xsl:value-of select="document(concat($parentItem_actual, 'text.xml'))/guide/chapter[1]/title"/></a>
-         </xsl:when>
-         <xsl:otherwise>
-           <!-- We need to recurse downwards; so we need to strip off a directory element off our absolute path to feed
-                into the next iteration... -->
-           <xsl:variable name="relative_path_depth" select="string-length($self)-string-length(translate($self, '/' , ''))"/>
-           <xsl:variable name="relative_path_fixed">
-             <xsl:for-each select="str:tokenize_plasmaroo($self, '/')[position() &lt; (($relative_path_depth - 1)*2 + 1)]">
-               <xsl:value-of select="."/>
-             </xsl:for-each>
-           </xsl:variable>
-           <xsl:call-template name="findNext">
-             <xsl:with-param name="self" select="$relative_path_fixed"/>
-           </xsl:call-template>
-         </xsl:otherwise>
-       </xsl:choose>
-      </xsl:otherwise>
-    </xsl:choose>
-  </xsl:template>
-
-  <xsl:template name="getLastNode">
-    <!-- This function recurses forward down nodes stopping at the very last include... -->
-    <xsl:param name="root"/>
-    <xsl:param name="path"/>
-    <xsl:variable name="include" select="document(concat($root, $path))/guide/include[last()]/@href"/>
-    <xsl:choose>
-      <xsl:when test="$include">
-       <xsl:call-template name="getLastNode">
-          <xsl:with-param name="root" select="$root"/>
-         <xsl:with-param name="path" select="concat(substring-before($path, 'text.xml'), $include, 'text.xml')"/>
-       </xsl:call-template>
-      </xsl:when>
-      <xsl:otherwise>
-       <xsl:value-of select="$path"/>
-      </xsl:otherwise>
-    </xsl:choose>
-  </xsl:template>
-
-  <xsl:template name="findPrevious">
-    <xsl:choose>
-      <!-- To find the "previous" node:
-          * Go down to our parent
-            * See if there are any nodes before us
-              * If we have a valid node that is before us
-              * Fully recurse up the node to get the last extremity
-            * Otherwise list the parent -->
-      <xsl:when test="/guide/@root">
-       <a href="#"><xsl:value-of select="/guide/chapter[1]/title"/></a>
-      </xsl:when>
-      <xsl:otherwise>
-       <!-- This document's path -->
-       <xsl:variable name="doc_self" select="concat(/guide/@self, 'text.xml')"/>
-       <!-- Turn the absolute path we have into a relative path so we can find ourselves in the
-            parent -->
-       <!-- FIXME: Bombproof the doc_self so it still works if it's missing a '/' on the end -->
-        <xsl:variable name="path_self" select="concat(str:tokenize(/guide/@self, '/')[last()], '/')"/>
-       <xsl:variable name="index_self" select="count(document(concat(/guide/@self, '../text.xml'))/guide/include[@href=$path_self]/preceding-sibling::*)-1"/>
-       <xsl:choose>
-         <xsl:when test="$index_self &gt; 0">
-           <!-- Relative path of the parent -->
-           <xsl:variable name="parentItem_path" select="document(concat(/guide/@self, '../text.xml'))/guide/@self"/>
-           <!-- Previous item in the parent -->
-           <xsl:variable name="parentItem_next" select="document(concat(/guide/@self, '../text.xml'))/guide/include[$index_self]/@href"/>
-           <xsl:variable name="myItem_path">
-           <xsl:call-template name="getLastNode">
-              <xsl:with-param name="root" select="$parentItem_path"/>
-             <xsl:with-param name="path" select="concat($parentItem_next, 'text.xml')"/>
-           </xsl:call-template>
-           </xsl:variable>
-           <!-- Make a relative <a> link; we need an absolute reference for the XSLT processor though... -->
-           <a href="{concat('../', substring-before($myItem_path, 'text.xml'), 'index.html')}"><xsl:value-of select="document(concat($parentItem_path, $myItem_path))/guide/chapter[1]/title"/></a>
-         </xsl:when>
-         <xsl:otherwise>
-           <a href="../index.html"><xsl:value-of select="document(concat(/guide/@self, '../text.xml'))/guide/chapter[1]/title"/></a>
-         </xsl:otherwise>
-       </xsl:choose>
-      </xsl:otherwise>
-    </xsl:choose>
-  </xsl:template>
-
-  <xsl:template name="findParent">
-    <xsl:choose>
-    <xsl:when test="not(/guide/@root)">
-      <a href="../index.html"><xsl:value-of select="document(concat(/guide/@self, '../text.xml'))/guide/chapter[1]/title"/></a>
-    </xsl:when>
-    <xsl:otherwise>
-      <a href="#"><xsl:value-of select="/guide/chapter[1]/title"/></a>
-    </xsl:otherwise>
-    </xsl:choose>
-  </xsl:template>
-
-  <xsl:template match="author">
-    <dt><xsl:value-of select="@name"/><xsl:if test="@email != ''"> &lt;<a href="mailto:{@email}"><xsl:value-of select="@email"/></a>&gt;</xsl:if></dt>
-    <dd><xsl:apply-templates/></dd>
-  </xsl:template>
-
-  <xsl:template match="authors">
-    <dl>
-    <xsl:apply-templates select="author"/>
-    </dl>
-  </xsl:template>
-</xsl:stylesheet>
diff --git a/devmanual.css b/devmanual.css
deleted file mode 100644 (file)
index 9f7e18a..0000000
+++ /dev/null
@@ -1,239 +0,0 @@
-div.header {
-    border-bottom: 3px solid #333333;
-    background-color: #666666;
-    color: #eeeeee;
-    margin: 0em 0em 0em 0em;
-    padding: 0.2em;
-    font-size: 70%;
-}
-
-div.navtop {
-    border-bottom: 1px dashed #333333;
-    text-align: center;
-}
-
-div.navbottom {
-    border-top: 1px dashed #333333;
-    text-align: center;
-    margin-top: 1em;
-}
-
-@media print {
-    div.header {
-        display: none;
-    }
-}
-
-div.header a:link, div.header a:visited,
-div.footer a:link, div.footer a:visited {
-    color: #eeeeee;
-    font-weight: bold;
-    text-decoration: none;
-}
-
-div.header a:hover, div.footer a:hover {
-    color: #eeeeee;
-    font-weight: bold;
-    text-decoration: underline;
-}
-
-div.footer {
-    text-align: center;
-    border-top: 3px solid #333333;
-    background-color: #666666;
-    color: #eeeeee;
-    margin: 0em 0em 0em 0em;
-    padding: 0em 0.2em;
-    font-size: 70%;
-}
-
-@media print {
-    div.footer {
-        display: none;
-    }
-}
-
-div.main {
-    padding: 1em 40px;
-    margin: 0em;
-    background-color: #eeeeee;
-    color: #333333;
-}
-
-body {
-    background-color: #666666;
-    color: #eeeeee;
-    padding: 0em;
-    margin: 0em;
-    font-family: "Verdana", "Arial", "Helvetica", sans-serif;
-}
-
-div.footer * img {
-    border-width: 0px;
-}
-
-th {
-    font-weight: bold;
-    text-align: left;
-    padding: 0.3em;
-}
-
-th, td {
-    padding-left: 0.3em;
-    padding-right: 0.3em;
-}
-
-div.main a:link, div.main a:visited {
-    color: #000099;
-    text-decoration: none;
-}
-
-div.main a[href]:hover {
-    color: #000099;
-    text-decoration: underline;
-}
-
-div.main pre a:link, div.main pre a:visited {
-    color: #fff0e0;
-    text-decoration: none;
-}
-
-div.main pre a[href]:hover {
-    color: #fff0e0;
-    text-decoration: underline;
-}
-
-code, tt {
-    color: #993333;
-}
-
-div.main p, div.main dd {
-    text-align: justify;
-}
-
-pre {
-    background-color: #1e1e27;
-    color: #cfbfad;
-    padding-top: 3px;
-    padding-bottom: 3px;
-    padding-left: 8px;
-    padding-right: 8px;
-}
-
-div.main h1 {
-    text-align: center;
-}
-
-div.main h2 {
-    text-align: left;
-    border-bottom: 1px dashed #333333;
-    margin-left: -30px;
-}
-
-div.main h3 {
-    text-align: left;
-    margin-left: -30px;
-}
-
-dt {
-    font-weight: bold;
-}
-
-dd p.first {
-    margin-top: 0.2em;
-}
-
-dd p.last {
-    margin-bottom: 0.2em;
-}
-
-div.figure, div.figure p {
-    text-align: center;
-    font-weight: bold;
-}
-
-code, pre, tt {
-    font-family: monospace;
-}
-
-div.warning    p.admonition-title,
-div.note       p.admonition-title,
-div.todo       p.admonition-title,
-div.admonition p.admonition-title,
-div.important  p.admonition-title {
-    font-weight: bold;
-    display: inline;
-}
-
-div.warning    p,
-div.note       p,
-div.todo       p,
-div.admonition p,
-div.important  p {
-    display: inline;
-}
-
-div.warning    p.admonition-title:after,
-div.note       p.admonition-title:after,
-div.todo       p.admonition-title:after,
-div.admonition p.admonition-title:after,
-div.important  p.admonition-title:after {
-    content: ":";
-}
-
-div.note, div.warning,
-div.important, div.todo,
-div.admonition {
-    padding: 4px;
-    text-align: justify;
-}
-
-div.note {
-    background-color: #c9c4ff;
-}
-
-div.warning {
-    background-color: #ee9999;
-}
-
-div.important {
-    background-color: #99ee99;
-}
-
-div.todo {
-    background-color: #cccccc;
-}
-
-div.admonition {
-    background-color: #ffffff;
-}
-
-blockquote.epigraph p {
-    font-size: 80%;
-    font-style: italic;
-}
-
-blockquote.epigraph p.attribution {
-    font-style: normal;
-}
-
-td.devbook {
-    vertical-align: top;
-}
-
-pre span.Normal { color: #cfbfad; background-color: #1e1e27; }
-pre span.Number { color: #506dbd; }
-pre span.Special { color: #c080d0; }
-pre span.Identifier { color: #ff8bff; }
-pre span.Type { color: #ff8bff; }
-pre span.PreProc { color: #409090; }
-pre span.String { color: #ffcd8b; background-color: #404040; }
-pre span.Constant { color: #ffcd8b; }
-pre span.lnr { color: #8b8bcd; background-color: #2e2e2e; }
-pre span.Comment { color: #cd8b00; }
-pre span.Statement { color: #808bed; }
-pre span.DiffAdd { color: #40c060; }
-pre span.Title { color: #40c060; font-weight: bold; }
-pre span.Underlined { font-weight: bold; color: #fff0c0; }
-
-/* vim: set ts=4 tw=80 et : */
diff --git a/ebuild-writing/common-mistakes/text.xml b/ebuild-writing/common-mistakes/text.xml
deleted file mode 100644 (file)
index 8fda324..0000000
+++ /dev/null
@@ -1,46 +0,0 @@
-<?xml version="1.0"?>
-<guide self="ebuild-writing/common-mistakes/">
-<chapter>
-<title>Common Mistakes</title>
-
-<body>
-<p>
-This section contains information on the common mistakes developers make when
-writing ebuilds.
-</p>
-</body>
-
-<section>
-<title>Invalid use of <c>static</c> use-flag</title>
-<body>
-The <c>static</c> use-flag should only be used to make a binary use static
-linking instead of dynamic linking.  It should not be used to make a library
-install static libraries.  The package should always (if possible) install both
-the dynamic and static libraries.
-</body>
-</section>
-
-<section>
-<title>Referencing the full path to documentation files that could be
-compressed</title>
-<body>
-When printing out to the users where to find files like INSTALL, do not specify
-the full path since <c>PORTAGE_COMPRESS</c> comes into play.  The file could be
-compressed with gzip, bzip2, or some other random compression tool.  So,
-instead of doing this:
-
-<codesample lang="ebuild">
-elog "They are listed in /usr/share/doc/${PF}/INSTALL.gz"
-</codesample>
-
-Do something like:
-
-<codesample lang="ebuild">
-elog "They are listed in the INSTALL file in /usr/share/doc/${PF}"
-</codesample>
-</body>
-</section>
-
-</chapter>
-
-</guide>
diff --git a/ebuild-writing/eapi/text.xml b/ebuild-writing/eapi/text.xml
deleted file mode 100644 (file)
index 9eb5fde..0000000
+++ /dev/null
@@ -1,336 +0,0 @@
-<?xml version="1.0"?>
-<guide self="ebuild-writing/eapi/">
-<chapter>
-<title>EAPI Usage and Description</title>
-
-<body>
-<p>
-This section provides usage and descriptions of the different EAPIs.
-</p>
-
-<section>
-<title>Usage of EAPIs</title>
-<body>
-<important>
-An overview about the important features of each EAPI is provided in the
-appendix of the Package Manager Specification.  The two-page leaflet
-can be printed out, consulted for reference and is available
-as <c>app-doc/pms</c> in the main tree.
-</important>
-<p>
-If EAPI is undefined in an ebuild, then EAPI="0" is selected. If you want to override
-the EAPI variable, you have to specify it at the top of the ebuild:
-</p>
-<codesample lang="ebuild">
-# Copyright 1999-2010 Gentoo Foundation
-# Distributed under the terms of the GNU General Public License v2
-# $Header: $
-
-EAPI=1
-inherit eutils
-
-</codesample>
-
-<important>
-EAPI must only be defined in ebuild files, not eclasses. (eclasses may have
-EAPI-conditional code)
-</important>
-
-</body>
-</section>
-
-<section>
-<title>EAPI="1"</title>
-<body>
-
-<ul>
-       <li>
-               <p><b>Default src_compile Phase Function</b></p>
-               <p>
-               Support for the <c>ECONF_SOURCE</c> variable, which is also supported by
-               <c>econf</c>, has been added to the default <c>src_compile</c> implementation.
-               </p>
-               <codesample lang="ebuild">
-src_compile() {
-       if [[ -x ${ECONF_SOURCE:-.}/configure ]] ; then
-               econf
-       fi
-       if [ -f Makefile ] || [ -f GNUmakefile ] || [ -f makefile ] ; then
-               emake || die "emake failed"
-       fi
-}
-               </codesample>
-       </li>
-       <li>
-               <p><b>SLOT dependencies</b></p>
-               <p>
-               Any valid atom can be constrained to match a specific SLOT. This
-               is accomplished by appending a colon to the atom, followed by a
-               SLOT value.
-               </p>
-               <p>
-               <b>SLOT dependency examples:</b>
-               <ul>
-                       <li><c>x11-libs/qt:3</c></li>
-                       <li><c>~x11-libs/qt-3.3.8:3</c></li>
-                       <li><c>&gt;=x11-libs/qt-3.3.8:3</c></li>
-                       <li><c>=x11-libs/qt-3.3*:3</c></li>
-               </ul>
-               </p>
-       </li>
-       <li>
-               <p><b>IUSE defaults</b></p>
-               <p>
-               Add + or - before the name of the use flag in IUSE to turn it on or off by
-               default.
-               </p>
-
-               <important>
-               The default USE-ordering is <c>USE_ORDER="env:pkg:conf:defaults:pkginternal:env.d"</c>
-               (see man make.conf)
-               </important>
-               <important>
-               Disabling default IUSE is pretty much useless as it does not
-               override the profile and user config (make.conf and package.use)
-               </important>
-
-               <codesample lang="ebuild">
-# Copyright 1999-2010 Gentoo Foundation
-# Distributed under the terms of the GNU General Public License v2
-# $Header: $
-
-EAPI=1
-
-IUSE="foo +bar"
-
-               </codesample>
-       </li>
-</ul>
-
-</body>
-</section>
-
-
-<section>
-<title>EAPI="2"</title>
-<body>
-
-<subsection>
-<title>Helpers</title>
-<body>
-<ul>
-       <li>
-               <p><b>doman Language Support</b></p>
-               <p>
-               <c>doman</c> automatically detects language codes and puts it in the
-               appropriate directory.
-               <codesample lang="ebuild">
-doman foo.1
-# will go into /usr/share/man/man1/foo.1
-doman foo.lang.1
-# will go into /usr/share/man/lang/man1/foo.1 with EAPI="2"
-               </codesample>
-               </p>
-       </li>
-</ul>
-</body>
-</subsection>
-
-<subsection>
-<title>Metadata</title>
-<body>
-<ul>
-       <li>
-               <p><b>Blocker Atoms</b></p>
-               <p>
-               <ul>
-                       <li>
-                               <p><b>New Meaning for Old Syntax</b></p>
-                               <p>
-                               Blocker atoms which use the previously existing !atom syntax now
-                               have a slightly different meaning. These blocker atoms indicate
-                               that conflicting packages may be temporarily installed
-                               simultaneously. When temporary simultaneous installation of
-                               conflicting packages occurs, the installation of a newer package
-                               may overwrite any colliding files that belong to an older package
-                               which is explicitly blocked. When such file collisions occur, the
-                               colliding files cease to belong to the older package, and they
-                               remain installed after the older package is eventually
-                               uninstalled. The older package is uninstalled only after any newer
-                               blocking packages have been merged on top of it.
-                       </p>
-                       </li>
-                       <li>
-                               <p><b>New !!atom Syntax</b></p>
-                               <p>
-                               A new !!atom syntax is now supported, for use in special cases for
-                               which temporary simultaneous installation of conflicting packages
-                               should not be allowed. If a given package happens to be blocked by
-                               a mixture of atoms consisting of both the !atom and !!atom
-                               syntaxes, the !!atom syntax takes precedence over the !atom
-                               syntax.
-                               </p>
-                       </li>
-               </ul>
-               </p>
-       </li>
-       <li>
-               <p><b>USE Dependencies</b></p>
-               <p>
-               It is possible to depend on USE-flags of packages.
-               </p>
-               <p>Examples:
-               <ul>
-                       <li><c>foo[bar]</c> means that package foo must have USE-flag bar
-                       enabled</li>
-                       <li><c>foo[bar,baz]</c> means that the package foo must have both
-                               the bar and baz USE-flags enabled
-                       </li>
-                       <li><c>foo[-bar,baz]</c> means that the packge foo must have the
-                               bar USE-flag disabled and baz USE-flag enabled</li>
-                       <li><c>foo[bar?]</c> means <c>bar? ( foo[bar] ) !bar? ( foo )</c></li>
-                       <li><c>foo[!bar?]</c> means <c>bar? ( foo ) !bar? ( foo[-bar] )</c></li>
-                       <li><c>foo[bar=]</c> means <c>bar? ( foo[bar] ) !bar? ( foo[-bar] )</c></li>
-                       <li><c>foo[!bar=]</c> means <c>bar? ( foo[-bar] ) !bar? ( foo[bar] )</c></li>
-               </ul>
-               </p>
-       </li>
-       <li>
-               <p><b>Customization of Output File Names in SRC_URI</b></p>
-               <p>
-               A new syntax is supported which allows customization of the output
-               file name for a given URI. In order to customize the output file
-               name, a given URI should be followed by a "<c>-&gt;</c>" operator which, in
-               turn, should be followed by the desired output file name. As
-               usual, all tokens, including the operator and output file name,
-               should be separated by whitespace.
-               </p>
-               <p>Example:</p>
-               <codesample lang="ebuild">
-SRC_URI="http://dl.google.com/earth/client/GE4/release_4_3/GoogleEarthLinux.bin
-                        -&gt; GoogleEarthLinux-${PV}.bin"
-               </codesample>
-       </li>
-</ul>
-</body>
-</subsection>
-
-<subsection>
-<title>Phases</title>
-<body>
-<ul>
-       <li>
-               <p><b>New <c>src_prepare</c> Phase Function</b></p>
-               <p>
-               A new src_prepare function is called after the <c>src_unpack</c>
-               function, with cwd initially set to <c>$S</c>.
-               </p>
-       </li>
-       <li>
-               <p><b>New <c>src_configure</c> Phase Function</b></p>
-               <p>
-               The configure portion of the <c>src_compile</c> function has been split
-               into a separate function which is named <c>src_configure</c>. The
-               <c>src_configure</c> function is called in-between the <c>src_prepare</c> and
-               <c>src_compile</c> functions.
-               </p>
-               <p>The default <c>src_configure</c> and <c>src_compile</c>
-               functions in EAPI=2:
-               <codesample lang="ebuild">
-src_configure() {
-       if [[ -x ${ECONF_SOURCE:-.}/configure ]] ; then
-               econf
-       fi
-}
-
-src_compile() {
-       if [ -f Makefile ] || [ -f GNUmakefile ] || [ -f makefile ] ; then
-               emake || die "emake failed"
-       fi
-}
-               </codesample>
-               </p>
-       </li>
-       <li>
-               <p><b>Execution Order of Phase Functions</b></p>
-               <p>
-               <ul>
-                       <li><c>pkg_setup</c></li>
-                       <li><c>src_unpack</c></li>
-                       <li><c>src_prepare</c></li>
-                       <li><c>src_configure</c></li>
-                       <li><c>src_compile</c></li>
-                       <li><c>src_test</c></li>
-                       <li><c>src_install</c></li>
-                       <li><c>pkg_preinst</c></li>
-                       <li><c>pkg_postinst</c></li>
-                       <li><c>pkg_prerm</c></li>
-                       <li><c>pkg_postrm</c></li>
-               </ul>
-               </p>
-       </li>
-       <li>
-               <p><b>Default Phase Functions</b></p>
-               <p>
-               The default <c>pkg_nofetch</c> and <c>src_*</c> phase functions are now
-               accessible via a function having a name that begins with <c>default_</c>
-               and ends with the respective phase function name. For example, a
-               call to a function with the name <c>default_src_compile</c> is equivalent
-               to a call to the default <c>src_compile</c> implementation.
-               </p>
-               <p>The default phase functions are:
-               <ul>
-                       <li><c>default_pkg_nofetch</c></li>
-                       <li><c>default_src_unpack</c></li>
-                       <li><c>default_src_prepare</c></li>
-                       <li><c>default_src_configure</c></li>
-                       <li><c>default_src_compile</c></li>
-                       <li><c>default_src_test</c></li>
-               </ul>
-               </p>
-       </li>
-       <li>
-               <p><b>Default Phase Function Alias</b></p>
-               <p>
-               A function named "<c>default</c>" is redefined for each phase so that it
-               will call the <c>default_*</c> function corresponding to the current
-               phase. For example, a call to the function named "<c>default</c>" during
-               the <c>src_compile</c> phase is equivalent to a call to the function
-               named <c>default_src_compile</c>.
-               </p>
-       </li>
-</ul>
-</body>
-</subsection>
-
-</body>
-</section>
-<section>
-<title>EAPI="3"</title>
-<body>
-
-<ul>
-       <li>
-               <p><b>Gentoo Prefix support</b></p>
-               <p>
-                       Support for the <c>EPREFIX</c>, <c>EROOT</c>, and <c>ED</c>
-                       variables. If an ebuild uses one of these, it must be EAPI3 aware.
-               </p>
-       </li>
-       <li>
-               <p><b>src_unpack() .tar.xz support</b></p>
-               <p>
-                       Support for the <c>.tar.xz</c> format from upstream tarballs.
-                       unpack() in src_unpack() will only operate on a .tar.xz tarball if
-                       the ebuild is EAPI3 aware.
-               </p>
-       </li>
-</ul>
-
-</body>
-</section>
-
-
-</body>
-</chapter>
-</guide>
diff --git a/ebuild-writing/error-handling/text.xml b/ebuild-writing/error-handling/text.xml
deleted file mode 100644 (file)
index 5951bb3..0000000
+++ /dev/null
@@ -1,140 +0,0 @@
-<?xml version="1.0"?>
-<guide self="ebuild-writing/error-handling/">
-<chapter>
-<title>Error Handling</title>
-
-<section>
-<title>Importance of Error Handling</title>
-<body>
-
-<p>
-Decent error handling is important because:
-</p>
-
-<ul>
-  <li>
-  Errors must be detected <e>before</e> portage tries to install a broken or
-  incomplete package onto the live filesystem. If build failures aren't caught,
-  a working package could be unmerged and replaced with nothing.
-  </li>
-  <li>
-  When receiving bug reports, it is a lot easier to figure out what went wrong
-  if you know exactly which call caused the error, rather than just knowing
-  that, say, something somewhere in <c>src_compile</c> broke.
-  </li>
-  <li>
-  Good error handling and notification can help cut down on the number of bug
-  reports received for a package.
-  </li>
-</ul>
-
-</body>
-</section>
-
-<section>
-<title>The <c>die</c> Function</title>
-<body>
-
-<p>
-The <c>die</c> function should be used to indicate a fatal error and abort the
-build. Its parameters should be the message to display.
-</p>
-
-<p>
-Although <c>die</c> will work with no parameters, a short message should always be
-provided to ease error identification. This is especially important when a
-function can die in multiple places.
-</p>
-
-<p>
-Some portage-provided functions will automatically die upon failure. Others will
-not. It is for example safe to omit the <c>|| die</c> after a call to <c>epatch</c>,
-but not <c>emake</c>. The reason is that external binaries are not able to call
-die that is a bash function. You can see what commands are external binaries
-with <c>ls /usr/lib/portage/bin/</c>.
-</p>
-
-<p>
-Sometimes displaying additional error information beforehand can be useful. Use
-<c>eerror</c> to do this. See <uri link="::ebuild-writing/messages"/>.
-</p>
-
-<p>
-It's best to use <c>|| die</c> too often than too little.
-</p>
-</body>
-</section>
-
-<section>
-<title><c>die</c> and Subshells</title>
-<body>
-
-<warning>
-<c>die</c> <b>will not work in a subshell</b>.
-</warning>
-
-<p>
-The following code will not work as expected, since the <c>die</c> is inside a
-subshell:
-</p>
-
-<codesample lang="ebuild">
-[[ -f foorc ]] &amp;&amp; ( update_foorc || die "Couldn't update foorc!" )
-</codesample>
-
-<p>
-The correct way to rewrite this is to use an <c>if</c> block:
-</p>
-
-<codesample lang="ebuild">
-if [[ -f foorc ]] ; then
-    update_foorc || die "Couldn't update foorc!"
-fi
-</codesample>
-
-<p>
-When using pipes, a subshell is introduced, so the following is unsafe:
-</p>
-
-<codesample lang="ebuild">
-cat list | while read file ; do epatch ${file} ; done
-</codesample>
-
-<p>
-Using input redirection (see <uri link="::tools-reference/cat/#Abuse of cat"/>)
-avoids this problem:
-</p>
-
-<codesample lang="ebuild">
-while read file ; do epatch ${file} ; done &lt; list
-</codesample>
-
-</body>
-</section>
-
-<section>
-<title>The <c>assert</c> Function and <c>$PIPESTATUS</c></title>
-<body>
-
-<p>
-When using pipes, simple conditionals and tests upon <c>$?</c> will not correctly
-detect errors occurring in anything except the final command in the chain. To get
-around this, <c>bash</c> provides the <c>$PIPESTATUS</c> variable, and portage
-provides the <c>assert</c> function to check this variable.
-</p>
-
-<codesample lang="ebuild">
-bunzip2 "${DISTDIR}/${VIM_RUNTIME_SNAP}" | tar xf
-assert
-</codesample>
-
-<p>
-If you need the gory details of <c>$PIPESTATUS</c>, see the bash manpage. Most of the
-time, <c>assert</c> is enough.
-</p>
-
-</body>
-</section>
-
-</chapter>
-</guide>
diff --git a/ebuild-writing/file-format/text.xml b/ebuild-writing/file-format/text.xml
deleted file mode 100644 (file)
index 9d00e6b..0000000
+++ /dev/null
@@ -1,168 +0,0 @@
-<?xml version="1.0"?>
-<guide self="ebuild-writing/file-format/">
-<chapter>
-<title>Ebuild File Format</title>
-
-<body>
-<p>
-An ebuild is a <c>bash</c> script which is executed within a special environment.
-Files should be simple text files with a <c>.ebuild</c> extension.
-</p>
-</body>
-
-<section>
-<title>File Naming Rules</title>
-<body>
-
-<p>
-An ebuild should be named in the form <c>name-version.ebuild</c>.
-</p>
-
-<p>
-The name section should contain only lowercase non-accented letters, the digits
-0-9, hyphens, underscores and plus characters. Uppercase characters are strongly
-discouraged, but technically valid.
-</p>
-
-<note>
-This is the same as <uri link="http://www.opengroup.org/onlinepubs/000095399/basedefs/xbd_chap03.html#tag_03_276">
-IEEE1003.1-2004-3.276</uri>, with the exception of the period character and with the
-addition of the plus character to keep GTK+ and friends happy.
-</note>
-
-<p>
-The version section is more complicated. It consists of one or more numbers
-separated by full stop (or period, or dot, or decimal point) characters (eg
-<c>1.2.3</c>, <c>20050108</c>). The final number may have a single letter following it
-(e.g. <c>1.2b</c>). This letter should not be used to indicate 'beta' status <d/>
-portage treats <c>1.2b</c> as being a later version than <c>1.2</c> or <c>1.2a</c>.
-</p>
-
-<p>
-There can be a suffix to version indicating the kind of release. In the following table,
-what portage considers to be the 'lowest' version comes first.
-</p>
-
-<table>
-  <tr>
-    <th>Suffix</th>
-    <th>Meaning</th>
-  </tr>
-  <tr>
-    <ti><c>_alpha</c></ti>
-    <ti>Alpha release (earliest)</ti>
-  </tr>
-  <tr>
-    <ti><c>_beta</c></ti>
-    <ti>Beta release</ti>
-  </tr>
-  <tr>
-    <ti><c>_pre</c></ti>
-    <ti>Pre release</ti>
-  </tr>
-  <tr>
-    <ti><c>_rc</c></ti>
-    <ti>Release candidate</ti>
-  </tr>
-  <tr>
-    <ti>(no suffix)</ti>
-    <ti>Normal release</ti>
-  </tr>
-  <tr>
-    <ti>_p</ti>
-    <ti>Patch level</ti>
-  </tr>
-</table>
-
-<p>
-Any of these suffixes may be followed by a non-zero positive integer.
-</p>
-
-<p>
-These suffixes can be chained together and will be processed iteratively.  To
-give some examples (the following list is from lowest version to highest):
-
-<ul>
-  <li>foo-1.0.0_alpha_pre</li>
-  <li>foo-1.0.0_alpha_rc1</li>
-  <li>foo-1.0.0_beta_pre</li>
-  <li>foo-1.0.0_beta_p1</li>
-</ul>
-</p>
-
-<p>
-No integer part of the version may be longer than 18 digits.
-</p>
-
-<p>
-Finally, version may have a Gentoo revision number in the form <c>-r1</c>. The initial
-Gentoo version should have no revision suffix, the first revision should be
-<c>-r1</c>, the second <c>-r2</c> and so on. See <uri link="::general-concepts/ebuild-revisions"/>.
-</p>
-
-<p>
-Overall, this gives us a filename like <c>libfoo-1.2.5b_pre5-r2.ebuild</c>.
-</p>
-
-</body>
-</section>
-
-<section>
-<title>Ebuild Header</title>
-<body>
-
-<p>
-All ebuilds committed to the tree should have a three line header immediately at
-the start indicating copyright. This must be an exact copy of the contents of
-<c>$(portageq portdir)/header.txt</c>. Ensure that the <c>$Header: $</c> line is not
-modified manually <d/> CVS will handle this line specially.
-</p>
-
-<codesample lang="ebuild">
-# Copyright 1999-2006 Gentoo Foundation
-# Distributed under the terms of the GNU General Public License v2
-# $Header: $
-</codesample>
-
-</body>
-</section>
-
-<section>
-<title>Indenting and Whitespace</title>
-<body>
-
-<p>
-Indenting in ebuilds must be done with tabs, one tab per indent
-level. Each tab represents four spaces. Tabs should only be used for
-indenting, never inside strings.
-</p>
-
-<p>
-Avoid trailing whitespace: repoman will warn you about this if your
-ebuild contains trailing or leading whitespace (whitespace instead of
-tabs for indentation) when you commit.
-</p>
-
-<p>
-Where possible, try to keep lines no wider than 80 positions. A
-'position' is generally the same as a character <d/> tabs are four
-positions wide, and multibyte characters are just one position wide.
-</p>
-
-</body>
-</section>
-
-<section>
-<title>Character Set</title>
-<body>
-<p>
-All ebuilds (and eclasses, metadata files and ChangeLogs) must use the
-UTF-8 character set. See <uri
-link="http://www.gentoo.org/proj/en/glep/glep-0031.html">GLEP 31</uri>
-for details.
-</p>
-</body>
-</section>
-
-</chapter>
-</guide>
diff --git a/ebuild-writing/functions/diagram.svg b/ebuild-writing/functions/diagram.svg
deleted file mode 100644 (file)
index 2ee75e8..0000000
+++ /dev/null
@@ -1,71 +0,0 @@
-<?xml version="1.0" standalone="no"?>
-<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" 
-    "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
-<svg viewBox="0 100 830 80" width="830" height="80" xmlns="http://www.w3.org/2000/svg" version="1.1">
-    <desc>Ebuild Function Order</desc>
-    <rect x="-10" y="-10" width="1000" height="1000" fill="#eeeeee" id="background" />
-
-    <rect x="10" y="110" width="80" height="30"
-        fill="#ccccff" stroke="black" stroke-width="2" />
-    <text style="text-anchor: middle;" x="50" y="130">pkg_setup</text>
-
-    <line x1="90" y1="125"  x2="130" y2="125" stroke-width="2" stroke="black" />
-    <line x1="130" y1="125" x2="122" y2="120" stroke-width="2" stroke="black" />
-    <line x1="130" y1="125" x2="122" y2="130" stroke-width="2" stroke="black" />
-
-    <rect x="130" y="110" width="80" height="30"
-        fill="#ffffff" stroke="black" stroke-width="2" />
-    <text style="text-anchor: middle;" x="170" y="130">src_unpack</text>
-
-    <line x1="210" y1="125" x2="250" y2="125" stroke-width="2" stroke="black" />
-    <line x1="250" y1="125" x2="242" y2="120" stroke-width="2" stroke="black" />
-    <line x1="250" y1="125" x2="242" y2="130" stroke-width="2" stroke="black" />
-
-    <rect x="250" y="110" width="80" height="30"
-        fill="#ffffff" stroke="black" stroke-width="2" />
-    <text style="text-anchor: middle;" x="290" y="130">src_compile</text>
-
-    <line x1="330" y1="125" x2="370" y2="125" stroke-width="2" stroke="black" />
-    <line x1="370" y1="125" x2="362" y2="120" stroke-width="2" stroke="black" />
-    <line x1="370" y1="125" x2="362" y2="130" stroke-width="2" stroke="black" />
-
-    <path d="M 330 125 Q 350 125 350 137 Q 350 150 370 150
-             L 450 150 Q 470 150 470 137 Q 470 125 490 125"
-        stroke-width="2" stroke="black" fill="none" />
-
-    <rect x="370" y="110" width="80" height="30"
-        fill="#ccffcc" stroke="black" stroke-width="2" />
-    <text style="text-anchor: middle;" x="410" y="130">src_test</text>
-
-    <line x1="450" y1="125" x2="490" y2="125" stroke-width="2" stroke="black" />
-    <line x1="490" y1="125" x2="482" y2="120" stroke-width="2" stroke="black" />
-    <line x1="490" y1="125" x2="482" y2="130" stroke-width="2" stroke="black" />
-
-    <rect x="490" y="110" width="80" height="30"
-        fill="#ffffff" stroke="black" stroke-width="2" />
-    <text style="text-anchor: middle;" x="530" y="130">src_install</text>
-
-    <line x1="570" y1="125" x2="610" y2="125" stroke-width="2" stroke="black" />
-    <line x1="610" y1="125" x2="602" y2="120" stroke-width="2" stroke="black" />
-    <line x1="610" y1="125" x2="602" y2="130" stroke-width="2" stroke="black" />
-
-    <rect x="610" y="110" width="80" height="30"
-        fill="#ccccff" stroke="black" stroke-width="2" />
-    <text style="text-anchor: middle;" x="650" y="130">pkg_preinst</text>
-
-    <line x1="690" y1="125" x2="730" y2="125" stroke-width="2" stroke="black" />
-    <line x1="730" y1="125" x2="722" y2="120" stroke-width="2" stroke="black" />
-    <line x1="730" y1="125" x2="722" y2="130" stroke-width="2" stroke="black" />
-
-    <rect x="730" y="110" width="80" height="30"
-        fill="#ccccff" stroke="black" stroke-width="2" />
-    <text style="text-anchor: middle;" x="770" y="130">pkg_postinst</text>
-
-    <path d="M  90 125 Q 110 125 110 142 Q 110 160 130 160
-             L 570 160 Q 590 160 590 142 Q 590 125 610 125"
-        stroke-width="2" stroke="black" fill="none" />
-
-</svg>
-
-<!-- vim: set ft=xml sw=4 sts=4 et : -->
-
diff --git a/ebuild-writing/functions/pkg_config/text.xml b/ebuild-writing/functions/pkg_config/text.xml
deleted file mode 100644 (file)
index 422089f..0000000
+++ /dev/null
@@ -1,70 +0,0 @@
-<?xml version="1.0"?>
-<guide self="ebuild-writing/functions/pkg_config/">
-<chapter>
-<title>pkg_config</title>
-
-<body>
-<table>
-  <tr>
-    <th>Function</th>
-    <ti><c>pkg_config</c></ti>
-  </tr>
-  <tr>
-    <th>Purpose</th>
-    <ti>Run any special post-install configuration</ti>
-  </tr>
-  <tr>
-    <th>Sandbox</th>
-    <ti>Disabled</ti>
-  </tr>
-  <tr>
-    <th>Privilege</th>
-    <ti>root</ti>
-  </tr>
-  <tr>
-    <th>Called for</th>
-    <ti>manual</ti>
-  </tr>
-</table>
-</body>
-
-<section>
-<title>Default <c>pkg_config</c></title>
-<body>
-<codesample lang="ebuild">
-pkg_config()
-{
-    eerror "This ebuild does not have a config function."
-}
-</codesample>
-</body>
-</section>
-
-<section>
-<title>Example <c>pkg_config</c></title>
-<body>
-<p>
-Taken from the <c>mysql</c> ebuilds. Note the use of <c>${ROOT}</c>.
-</p>
-
-<codesample lang="ebuild">
-pkg_config() {
-    if [ ! -d "${ROOT}"/var/lib/mysql/mysql ] ; then
-        einfo "Press ENTER to create the mysql database and set proper"
-        einfo "permissions on it, or Control-C to abort now..."
-        read
-        "${ROOT}"/usr/bin/mysql_install_db
-    else
-        einfo "Hmm, it appears as though you already have the mysql"
-        einfo "database in place.  If you are having problems trying"
-        einfo "to start mysqld, perhaps you need to manually run"
-        einfo "/usr/bin/mysql_install_db and/or check your config"
-        einfo "file(s) and/or database(s) and/or logfile(s)."
-    fi
-}
-</codesample>
-</body>
-</section>
-
-</chapter>
-</guide>
diff --git a/ebuild-writing/functions/pkg_nofetch/text.xml b/ebuild-writing/functions/pkg_nofetch/text.xml
deleted file mode 100644 (file)
index f360607..0000000
+++ /dev/null
@@ -1,76 +0,0 @@
-<?xml version="1.0"?>
-<guide self="ebuild-writing/functions/pkg_nofetch/">
-<chapter>
-<title>pkg_nofetch</title>
-
-<body>
-<table>
-  <tr>
-    <th>Function</th>
-    <ti><c>pkg_nofetch</c></ti>
-  </tr>
-  <tr>
-    <th>Purpose</th>
-    <ti>Tell the user how to deal with fetch-restricted packages</ti>
-  </tr>
-  <tr>
-    <th>Sandbox</th>
-    <ti>Enabled</ti>
-  </tr>
-  <tr>
-    <th>Privilege</th>
-    <ti>root</ti>
-  </tr>
-  <tr>
-    <th>Called for</th>
-    <ti>ebuild</ti>
-  </tr>
-</table>
-</body>
-
-<section>
-<title>Default <c>pkg_nofetch</c></title>
-<body>
-<codesample lang="ebuild">
-pkg_nofetch()
-{
-    [ -z "${SRC_URI}" ] &amp;&amp; return
-
-    echo "!!! The following are listed in SRC_URI for ${PN}:"
-    for MYFILE in `echo ${SRC_URI}`; do
-        echo "!!!   $MYFILE"
-    done
-    return
-}
-</codesample>
-</body>
-</section>
-
-<section>
-<title>Sample <c>pkg_nofetch</c></title>
-<body>
-<codesample lang="ebuild">
-pkg_nofetch() {
-    einfo "Please download"
-    einfo "  - ${P}-main.tar.bz2"
-    einfo "  - ${P}-extras.tar.bz2"
-    einfo "from ${HOMEPAGE} and place them in ${DISTDIR}"
-}
-</codesample>
-</body>
-</section>
-
-<section>
-<title>Notes on <c>pkg_nofetch</c></title>
-<body>
-<p>
-This function is only triggered for packages which
-have <c>RESTRICT="fetch"</c> (see <uri link="::general-concepts/mirrors#Restricting Automatic Mirroring"/>)
-set, and only if one or more components listed in <c>SRC_URI</c> are not
-already available in the <c>distfiles</c> directory.
-</p>
-</body>
-</section>
-
-</chapter>
-</guide>
diff --git a/ebuild-writing/functions/pkg_postinst/text.xml b/ebuild-writing/functions/pkg_postinst/text.xml
deleted file mode 100644 (file)
index 8b86c4c..0000000
+++ /dev/null
@@ -1,74 +0,0 @@
-<?xml version="1.0"?>
-<guide self="ebuild-writing/functions/pkg_postinst/">
-<chapter>
-<title>pkg_postinst</title>
-
-<body>
-<table>
-  <tr>
-    <th>Function</th>
-    <ti><c>pkg_postinst</c></ti>
-  </tr>
-  <tr>
-    <th>Purpose</th>
-    <ti>Called after image is installed to <c>${ROOT}</c></ti>
-  </tr>
-  <tr>
-    <th>Sandbox</th>
-    <ti>Disabled</ti>
-  </tr>
-  <tr>
-    <th>Privilege</th>
-    <ti>root</ti>
-  </tr>
-  <tr>
-    <th>Called for</th>
-    <ti>ebuild, binary</ti>
-  </tr>
-</table>
-</body>
-
-<section>
-<title>Default <c>pkg_postinst</c></title>
-<body>
-<codesample lang="ebuild">
-pkg_postinst()
-{
-    return
-}
-</codesample>
-</body>
-</section>
-
-<section>
-<title>Sample <c>pkg_postinst</c></title>
-<body>
-<codesample lang="ebuild">
-pkg_postinst() {
-    if $OLD_FLUXBOX_VERSION ; then
-        ewarn "You must restart fluxbox before using the [include] /directory/"
-        ewarn "feature if you are upgrading from an older fluxbox!"
-        ewarn " "
-    fi
-    elog "If you experience font problems, or if fluxbox takes a very"
-    elog "long time to start up, please try the 'disablexmb' USE flag."
-    elog "If that fails, please report bugs upstream."
-}
-</codesample>
-</body>
-</section>
-
-<section>
-<title>Common <c>pkg_postinst</c> Tasks</title>
-<body>
-<p>
-The most common use for <c>pkg_postinst</c> is to display post-install
-informational messages or warnings.  If you want to display selective
-upgrade messages, you should do the call to <c>has_version</c> in an
-earlier phase, like <c>pkg_preinst</c>, and store the result in a global
-variable.</p>
-</body>
-</section>
-
-</chapter>
-</guide>
diff --git a/ebuild-writing/functions/pkg_postrm/text.xml b/ebuild-writing/functions/pkg_postrm/text.xml
deleted file mode 100644 (file)
index fa2a21d..0000000
+++ /dev/null
@@ -1,65 +0,0 @@
-<?xml version="1.0"?>
-<guide self="ebuild-writing/functions/pkg_postrm/">
-<chapter>
-<title>pkg_postrm</title>
-
-<body>
-<table>
-  <tr>
-    <th>Function</th>
-    <ti><c>pkg_postrm</c></ti>
-  </tr>
-  <tr>
-    <th>Purpose</th>
-    <ti>Called after a package is unmerged</ti>
-  </tr>
-  <tr>
-    <th>Sandbox</th>
-    <ti>Disabled</ti>
-  </tr>
-  <tr>
-    <th>Privilege</th>
-    <ti>root</ti>
-  </tr>
-  <tr>
-    <th>Called for</th>
-    <ti>ebuild, binary</ti>
-  </tr>
-</table>
-</body>
-
-<section>
-<title>Default <c>pkg_postrm</c></title>
-<body>
-<codesample lang="ebuild">
-pkg_postrm()
-{
-    return
-}
-</codesample>
-</body>
-</section>
-
-<section>
-<title>Sample <c>pkg_postrm</c></title>
-<body>
-<codesample lang="ebuild">
-pkg_postrm() {
-    fdo-mime_mime_database_update
-}
-</codesample>
-</body>
-</section>
-
-<section>
-<title>Common <c>pkg_postrm</c> Tasks</title>
-<body>
-<p>
-<c>pkg_postrm</c> is is used to update symlinks, cache files and other
-generated content after a package has been uninstalled.
-</p>
-</body>
-</section>
-
-</chapter>
-</guide>
diff --git a/ebuild-writing/functions/pkg_preinst/text.xml b/ebuild-writing/functions/pkg_preinst/text.xml
deleted file mode 100644 (file)
index 9cdeb4a..0000000
+++ /dev/null
@@ -1,84 +0,0 @@
-<?xml version="1.0"?>
-<guide self="ebuild-writing/functions/pkg_preinst/">
-<chapter>
-<title>pkg_preinst</title>
-
-<body>
-<table>
-  <tr>
-    <th>Function</th>
-    <ti><c>pkg_preinst</c></ti>
-  </tr>
-  <tr>
-    <th>Purpose</th>
-    <ti>Called before image is installed to <c>${ROOT}</c></ti>
-  </tr>
-  <tr>
-    <th>Sandbox</th>
-    <ti>Disabled</ti>
-  </tr>
-  <tr>
-    <th>Privilege</th>
-    <ti>root</ti>
-  </tr>
-  <tr>
-    <th>Called for</th>
-    <ti>ebuild, binary</ti>
-  </tr>
-</table>
-</body>
-
-<section>
-<title>Default <c>pkg_preinst</c></title>
-<body>
-<codesample lang="ebuild">
-pkg_preinst()
-{
-    return
-}
-</codesample>
-</body>
-</section>
-
-<section>
-<title>Sample <c>pkg_preinst</c></title>
-<body>
-<codesample lang="ebuild">
-pkg_preinst() {
-    enewgroup foo
-    enewuser foo -1 /bin/false /dev/null foo
-}
-</codesample>
-</body>
-</section>
-
-<section>
-<title>Common <c>pkg_preinst</c> Tasks</title>
-<body>
-<p>
-There are a few things that are often done in <c>pkg_preinst</c>:
-</p>
-
-<ul>
-  <li>
-  Adding users and groups. However, since <c>pkg_preinst</c> may be called 
-  after <c>src_compile</c>, <c>pkg_setup</c> is the more suitable location for
-  user creation <d/> see <uri link="::ebuild-writing/users-and-groups"/>.
-  </li>
-  <li>
-  Modifying the install image for a particular system. This function
-  allows system-specific customisation to be done even when installing
-  from a binary. The most useful example is probably smart
-  configuration file updating <d/> a <c>pkg_preinst</c> could check a
-  configuration file in <c>${ROOT}/etc/</c> and create a smart updated
-  version in <c>${D}/etc/</c> (see
-  <uri link="::general-concepts/install-destinations"/>) rather than
-  always trying to install the default configuration file (remember
-  <uri link="::general-concepts/config-protect"/>).
-  </li>
-</ul>
-</body>
-</section>
-
-</chapter>
-</guide>
diff --git a/ebuild-writing/functions/pkg_prerm/text.xml b/ebuild-writing/functions/pkg_prerm/text.xml
deleted file mode 100644 (file)
index d9f8a6f..0000000
+++ /dev/null
@@ -1,66 +0,0 @@
-<?xml version="1.0"?>
-<guide self="ebuild-writing/functions/pkg_prerm/">
-<chapter>
-<title>pkg_prerm</title>
-
-<body>
-<table>
-  <tr>
-    <th>Function</th>
-    <ti><c>pkg_prerm</c></ti>
-  </tr>
-  <tr>
-    <th>Purpose</th>
-    <ti>Called before a package is unmerged</ti>
-  </tr>
-  <tr>
-    <th>Sandbox</th>
-    <ti>Disabled</ti>
-  </tr>
-  <tr>
-    <th>Privilege</th>
-    <ti>root</ti>
-  </tr>
-  <tr>
-    <th>Called for</th>
-    <ti>ebuild, binary</ti>
-  </tr>
-</table>
-</body>
-
-<section>
-<title>Default <c>pkg_prerm</c></title>
-<body>
-<codesample lang="ebuild">
-pkg_prerm()
-{
-    return
-}
-</codesample>
-</body>
-</section>
-
-<section>
-<title>Sample <c>pkg_prerm</c></title>
-<body>
-<codesample lang="ebuild">
-pkg_prerm() {
-    # clean up temp files
-    [[ -d "${ROOT}/var/tmp/foo" ]] &amp;&amp; rm -rf "${ROOT}/var/tmp/foo"
-}
-</codesample>
-</body>
-</section>
-
-<section>
-<title>Common <c>pkg_prerm</c> Tasks</title>
-<body>
-<p>
-<c>pkg_prerm</c> is used to clean up any files that would otherwise prevent
-a clean unmerge.
-</p>
-</body>
-</section>
-
-</chapter>
-</guide>
diff --git a/ebuild-writing/functions/pkg_setup/text.xml b/ebuild-writing/functions/pkg_setup/text.xml
deleted file mode 100644 (file)
index a7fe9d2..0000000
+++ /dev/null
@@ -1,67 +0,0 @@
-<?xml version="1.0"?>
-<guide self="ebuild-writing/functions/pkg_setup/">
-<chapter>
-<title>pkg_setup</title>
-
-<body>
-<table>
-  <tr>
-    <th>Function</th>
-    <ti><c>pkg_setup</c></ti>
-  </tr>
-  <tr>
-    <th>Purpose</th>
-    <ti>Pre-build environment configuration and checks</ti>
-  </tr>
-  <tr>
-    <th>Sandbox</th>
-    <ti>Disabled</ti>
-  </tr>
-  <tr>
-    <th>Privilege</th>
-    <ti>root</ti>
-  </tr>
-  <tr>
-    <th>Called for</th>
-    <ti>ebuild, binary</ti>
-  </tr>
-</table>
-</body>
-
-<section>
-<title>Default <c>pkg_setup</c></title>
-<body>
-<codesample lang="ebuild">
-pkg_setup()
-{
-    return
-}
-</codesample>
-</body>
-</section>
-
-<section>
-<title>Sample <c>pkg_setup</c></title>
-<body>
-<codesample lang="ebuild">
-pkg_setup() {
-    # We need to know which GUI we're building in several
-    # different places, so work it out here.
-    if use gtk ; then
-        if use gtk2 ; then
-            export mypkg_gui="gtk2"
-        else
-            export mypkg_gui="gtk1"
-        fi
-    elif use motif then
-        export mypkg_gui="motif"
-    else
-        export mypkg_gui="athena"
-    fi
-}
-</codesample>
-</body>
-</section>
-
-</chapter>
-</guide>
diff --git a/ebuild-writing/functions/src_compile/build-environment/text.xml b/ebuild-writing/functions/src_compile/build-environment/text.xml
deleted file mode 100644 (file)
index ff385f0..0000000
+++ /dev/null
@@ -1,150 +0,0 @@
-<?xml version="1.0"?>
-<guide self="ebuild-writing/functions/src_compile/build-environment/">
-<chapter>
-<title>Configuring Build Environment</title>
-
-<body>
-<p>
-Sometimes it is necessary to manipulate certain aspects of the user's
-build environment before running <c>./configure</c>. The <c>flag-o-matic</c>
-eclass is the best choice for manipulating <c>CFLAGS</c>, <c>LDFLAGS</c>
-and suchlike.
-</p>
-
-<note>
-Except where otherwise specified, any function which operates on
-<c>CFLAGS</c> also operates on <c>CXXFLAGS</c>.
-</note>
-
-<p>
-Ebuilds must not simply ignore user CFLAGS, CXXFLAGS or LDFLAGS<d/> see
-<uri link="::general-concepts/user-environment#Not Filtering Variables"/>.
-</p>
-</body>
-
-<section>
-<title>Guidelines for Flag Filtering</title>
-<body>
-
-<p>
-If a package breaks with any reasonable <c>CFLAGS</c>, it is best to filter the
-problematic flag if a bug report is received. Reasonable <c>CFLAGS</c> are
-<c>-march=</c>, <c>-mcpu=</c>, <c>-mtune=</c> (depending upon
-arch), <c>-O2</c>, <c>-Os</c> and <c>-fomit-frame-pointer</c>. Note that
-<c>-Os</c> should usually be replaced with <c>-O2</c> rather than being
-stripped entirely. The <c>-fstack-protector</c> flag should probably be
-in this group too, although our hardened team claim that this flag
-never ever breaks anything...
-</p>
-
-<p>
-The <c>-pipe</c> flag doesn't affect the generated code, so it's not really
-relevant here, but it's a sensible flag to have set globally.
-</p>
-
-<p>
-If a package breaks with other (insane) <c>CFLAGS</c>, it is perfectly
-OK to close the bug with a <b>WONTFIX</b> suggesting that the user
-picks more sensible global <c>CFLAGS</c>. Similarly, if you suspect
-that a bug is caused by insane <c>CFLAGS</c>, an <b>INVALID</b> resolution is
-suitable.
-</p>
-
-<p>
-All of the following assumes that the ebuild has an <c>inherit flag-o-matic</c>
-line in the correct place.
-</p>
-
-</body>
-</section>
-
-<section>
-<title>Simple Flag Stripping</title>
-<body>
-
-<p>
-The <c>filter-flags</c> function can be used to remove a particular flag from
-<c>CFLAGS</c>. Multiple arguments can be supplied; each is the name of a flag to
-remove.
-</p>
-
-<codesample lang="ebuild">
-    # -fomit-frame-pointer leads to nasty broken code on sparc thanks to a
-    # rather icky asm function
-    use sparc &amp;&amp; filter-flags -fomit-frame-pointer
-</codesample>
-
-<p>
-There is a <c>filter-ldflags</c> function available which does the equivalent
-for <c>LDFLAGS</c>.
-</p>
-
-<p>
-If a package is known to be very <c>CFLAGS</c> sensitive, the
-<c>strip-flags</c> function will remove most flags, leaving only a minimal
-conservative set of flags.
-</p>
-
-<codesample lang="ebuild">
-    # Our app hates screwy flags
-    strip-flags
-</codesample>
-
-</body>
-</section>
-
-<section>
-<title>Flag Replacement</title>
-<body>
-
-<p>
-To replace a flag with a different one, use <c>replace-flags</c>. This
-is most commonly used to replace <c>-Os</c> with <c>-O2</c>
-(or <c>-O3</c> with <c>-O2</c> if you are feeling kind).
-</p>
-
-<codesample lang="ebuild">
-    # Seems to have issues with -Os, switch to -O2
-    replace-flags -Os -O2
-</codesample>
-
-<p>
-There is also a special function named <c>replace-cpu-flags</c> for
-replacing CPU (<c>-mtune</c>, <c>-mcpu</c>, <c>-march</c>) designation
-flags. The last argument is the flag to use; previous arguments are
-the flags to be replaced.
-</p>
-
-<codesample lang="ebuild">
-    # Can't use ultrasparc or ultrasparc3 code, drop to v9
-    replace-cpu-flags ultrasparc ultrasparc3 v9
-</codesample>
-
-</body>
-</section>
-
-<section>
-<title>Adding Additional Flags</title>
-<body>
-<p>
-Sometimes it is necessary to add in additional <c>CFLAGS</c>
-or <c>LDFLAGS</c>. The <c>append-flags</c> and <c>append-ldflags</c>
-functions can be used here.
-</p>
-
-<codesample lang="ebuild">
-    # If we're using selinux, we need to add a -D
-    use selinux &amp;&amp; append-flags "-DWITH_SELINUX"
-
-    # Secure linking needed, since we're setuid root
-    append-ldflags -Wl,-z,now
-</codesample>
-
-<p>
-See <uri link="::eclass-reference/flag-o-matic.eclass/"/> for a full reference.
-</p>
-</body>
-</section>
-
-</chapter>
-</guide>
diff --git a/ebuild-writing/functions/src_compile/building/text.xml b/ebuild-writing/functions/src_compile/building/text.xml
deleted file mode 100644 (file)
index 700f0f1..0000000
+++ /dev/null
@@ -1,82 +0,0 @@
-<?xml version="1.0"?>
-<guide self="ebuild-writing/functions/src_compile/building/">
-<chapter>
-<title>Building a Package</title>
-
-<body>
-<p>
-The <c>emake</c> function should be used to call <c>make</c>. This will ensure that
-the user's <c>MAKEOPTS</c> are used correctly. The <c>emake</c> function passes on
-any arguments provided, so it can be used to make non-default targets (<c>emake
-extras</c>), for example. Occasionally you might encounter a screwy non-autotools
-<c>Makefile</c> that explodes with <c>emake</c>, but this is rare.
-</p>
-
-<p>
-Builds should be tested with various <c>-j</c> settings in <c>MAKEOPTS</c> to ensure
-that the build parallelises properly. If a package does <e>not</e> parallelise
-cleanly, it should be patched.
-</p>
-
-<p>
-If patching <e>really</e> isn't an option, <c>emake -j1</c> should be
-used. However, when doing this please remember that you are seriously
-hurting build times for many non-x86 users in particular. Forcing
-a <c>-j1</c> can increase build times from a few minutes to an hour on
-some MIPS and SPARC systems.
-</p>
-</body>
-
-<section>
-<title>Fixing Compiler Usage</title>
-<body>
-
-<p>
-Sometimes a package will try to use a bizarre compiler, or will need to be told
-which compiler to use. In these situations, the <c>tc-getCC()</c> function from
-<c>toolchain-funcs.eclass</c> should be used. Other similar functions are available
-<d/> these are documented in <c>man toolchain-funcs.eclass</c>.
-</p>
-
-<note>
-It is <e>not</e> correct to use the <c>${CC}</c> variable for this purpose.
-</note>
-
-<p>
-Sometimes a package will not use the user's <c>${CFLAGS}</c> or <c>${LDFLAGS}</c>.
-This must be worked around, as sometimes these variables are used for specifying
-critical ABI options. In these cases, the build scripts should be modified (for
-example, with <c>sed</c>) to use <c>${CFLAGS}</c> or <c>${LDFLAGS}</c> correctly.
-</p>
-
-<codesample lang="ebuild">
-inherit flag-o-matic toolchain-funcs
-
-src_compile() {
-    # -Os not happy
-    replace-flags -Os -O2
-
-    # We have a weird build.sh to work with which ignores our
-    # compiler preferences. yay!
-    sed -i -e "s:cc -O2:$(tc-getCC) ${CFLAGS} ${LDFLAGS}:" build.sh \
-        || die "sed fix failed. Uh-oh..."
-    ./build.sh || die "Build failed!"
-}
-</codesample>
-
-<note>
-When using <c>sed</c> with <c>CFLAGS</c> or <c>LDFLAGS</c>, it is not safe to use
-a comma or a slash as a delimiter. The recommended character is a colon.
-</note>
-
-<p>
-Portage performs a QA check which verifies if LDFLAGS are respected. This QA check
-is enabled only when <c>LDFLAGS</c> variable contains <c>-Wl,--hash-style=gnu</c>.
-(This flag can be used only on systems which use <c>sys-libs/glibc</c> except for
-machines with a MIPS CPU.)
-</p>
-
-</body>
-</section>
-</chapter>
-</guide>
diff --git a/ebuild-writing/functions/src_compile/configuring/text.xml b/ebuild-writing/functions/src_compile/configuring/text.xml
deleted file mode 100644 (file)
index dced3d0..0000000
+++ /dev/null
@@ -1,82 +0,0 @@
-<?xml version="1.0"?>
-<guide self="ebuild-writing/functions/src_compile/configuring/">
-<chapter>
-<title>Configuring a Package</title>
-
-<body>
-<p>
-Many packages come with an autoconf-generated <c>./configure</c>
-script for checking the build environment and configuring optional
-support for libraries. The <c>econf</c> function should be used where
-possible <d/> this will provide correct build and path specifications for
-a Gentoo environment.
-</p>
-
-<p>
-Often the configure script will try to automatically enable support
-for optional components based upon installed packages. This
-must <b>not</b> be allowed to happen. For example, if a user has Perl
-installed but has <c>USE="-perl"</c>, packages with <e>optional</e>
-Perl support must not link against Perl. This automatic detection can
-usually be overridden using <c>--enable-</c> and <c>--disable</c>
-or <c>--with-</c> and <c>--without-</c> switches (but note that these
-don't always work <d/> make sure these are tested properly!).
-</p>
-
-<p>
-The <c>use_enable</c> and <c>use_with</c> utility functions should,
-where appropriate, be used to generate these switches.
-</p>
-
-<codesample lang="ebuild">
-src_compile() {
-    # We have optional perl, python and ruby support
-    econf \
-        $(use_enable perl ) \
-        $(use_enable python ) \
-        $(use_enable ruby )
-
-    # ...
-}
-
-src_compile() {
-    # Our package optional IPv6 support which uses --with rather than
-    # --enable / --disable
-
-    econf $(use_with ipv6 )
-
-    # ...
-}
-</codesample>
-
-<p>
-Sometimes the package's choice of name for the option will not exactly
-match the name or case of the <c>USE</c> flag. This is very often the
-case with the <c>X</c> flag. For these situations, there are two
-argument forms:
-</p>
-
-<codesample lang="ebuild">
-src_compile() {
-    # Our package has optional perl, python and ruby support
-    econf \
-        $(use_enable perl perlinterp ) \
-        $(use_enable python pythoninterp ) \
-        $(use_enable ruby rubyinterp )
-
-    # ...
-}
-
-src_compile() {
-    econf $(use_with X x11 )
-}
-</codesample>
-
-<p>
-To check for an unset <c>USE</c> flag, the <c>use_enable !flag</c>
-form can be used.
-</p>
-</body>
-
-</chapter>
-</guide>
diff --git a/ebuild-writing/functions/src_compile/distutils/text.xml b/ebuild-writing/functions/src_compile/distutils/text.xml
deleted file mode 100644 (file)
index bf9157c..0000000
+++ /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/no-build-system/text.xml b/ebuild-writing/functions/src_compile/no-build-system/text.xml
deleted file mode 100644 (file)
index 99b873a..0000000
+++ /dev/null
@@ -1,61 +0,0 @@
-<?xml version="1.0"?>
-<guide self="ebuild-writing/functions/src_compile/no-build-system/">
-<chapter>
-<title>No Build System</title>
-
-<body>
-<p>
-Occasionally some really small packages are shipped simply as a single
-<c>.c</c> file. In these circumstances, you can either write your own
-<c>Makefile</c> and ship it with the source tarball, or just manually
-compile the thing from within the ebuild, preferebly explaining why.
-Here's an example, from <c>app-misc/hilite</c>:
-</p>
-
-<codesample lang="ebuild">
-src_compile() {
-    $(tc-getCC) ${LDFLAGS} ${CFLAGS} -o ${PN} ${P}.c || die
-}
-</codesample>
-
-<p>
-Here's an example from <c>x11-plugins/asclock</c>, which ships with a
-broken build system that doesn't actually work:
-</p>
-
-<codesample lang="ebuild">
-src_compile() {
-    local x
-    for x in asclock parser symbols config
-    do
-        $(tc-getCC) \
-            ${CPPFLAGS} ${CFLAGS} ${ASFLAGS} \
-            -I/usr/include \
-            -Dlinux \
-            -D_POSIX_C_SOURCE=199309L \
-            -D_POSIX_SOURCE \
-            -D_XOPEN_SOURCE \
-            -D_BSD_SOURCE \
-            -D_SVID_SOURCE \
-            -DFUNCPROTO=15 \
-            -DNARROWPROTO \
-            -c -o ${x}.o ${x}.c || die "compile asclock failed"
-    done
-    $(tc-getCC) \
-        ${LDFLAGS} \
-        -o asclock \
-        asclock.o parser.o symbols.o config.o \
-        -L/usr/lib \
-        -L/usr/lib/X11 \
-        -lXpm -lXext -lX11 || die "link asclock failed"
-}
-</codesample>
-
-<p>
-A possibly better alternative would be to patch the build system
-and send it upstream.
-</p>
-
-</body>
-</chapter>
-</guide>
diff --git a/ebuild-writing/functions/src_compile/text.xml b/ebuild-writing/functions/src_compile/text.xml
deleted file mode 100644 (file)
index 68366dc..0000000
+++ /dev/null
@@ -1,84 +0,0 @@
-<?xml version="1.0"?>
-<guide self="ebuild-writing/functions/src_compile/">
-<chapter>
-<title>src_compile</title>
-
-<body>
-<table>
-  <tr>
-    <th>Function</th>
-    <ti><c>src_compile</c></ti>
-  </tr>
-  <tr>
-    <th>Purpose</th>
-    <ti>Configure and build the package.</ti>
-  </tr>
-  <tr>
-    <th>Sandbox</th>
-    <ti>Enabled</ti>
-  </tr>
-  <tr>
-    <th>Privilege</th>
-    <ti>user</ti>
-  </tr>
-  <tr>
-    <th>Called for</th>
-    <ti>ebuild</ti>
-  </tr>
-</table>
-</body>
-
-<section>
-<title>Default <c>src_compile</c></title>
-<body>
-<codesample lang="ebuild">
-src_compile() {
-    if [ -x ./configure ]; then
-        econf
-    fi
-    if [ -f Makefile ] || [ -f GNUmakefile ] || [ -f makefile ]; then
-        emake || die "emake failed"
-    fi
-}
-</codesample>
-</body>
-</section>
-
-<section>
-<title>Sample <c>src_compile</c></title>
-<body>
-<codesample lang="ebuild">
-src_compile() {
-    use sparc &amp;&amp; filter-flags -fomit-frame-pointer
-    append-ldflags -Wl,-z,now
-
-    econf \
-        $(use_enable ssl ) \
-        $(use_enable perl perlinterp )
-
-    emake || die "Make failed!"
-}
-</codesample>
-</body>
-</section>
-
-<section>
-<title><c>src_compile</c> Processes</title>
-<body>
-<p>
-The following subsections cover different topics which often occur when writing
-<c>src_compile</c> functions.
-</p>
-
-<contentsTree/>
-</body>
-</section>
-
-</chapter>
-
-<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_install/text.xml b/ebuild-writing/functions/src_install/text.xml
deleted file mode 100644 (file)
index 039a7e7..0000000
+++ /dev/null
@@ -1,191 +0,0 @@
-<?xml version="1.0"?>
-<guide self="ebuild-writing/functions/src_install/">
-<chapter>
-<title>src_install</title>
-
-<body>
-<table>
-  <tr>
-    <th>Function</th>
-    <ti><c>src_install</c></ti>
-  </tr>
-  <tr>
-    <th>Purpose</th>
-    <ti>Install a package to <c>${D}</c></ti>
-  </tr>
-  <tr>
-    <th>Sandbox</th>
-    <ti>Enabled</ti>
-  </tr>
-  <tr>
-    <th>Privilege</th>
-    <ti>root</ti>
-  </tr>
-  <tr>
-    <th>Called for</th>
-    <ti>ebuild</ti>
-  </tr>
-</table>
-</body>
-
-<section>
-<title>Default <c>src_install</c></title>
-<body>
-<codesample lang="ebuild">
-src_install()
-{
-    return
-}
-</codesample>
-</body>
-</section>
-
-<section>
-<title>Sample <c>src_install</c></title>
-<body>
-<codesample lang="ebuild">
-src_install() {
-    emake DESTDIR="${D}" install || die "Install failed"
-    dodoc README CHANGES || die
-}
-</codesample>
-</body>
-</section>
-
-<section>
-<title>Easy Installs</title>
-<body>
-<p>
-Often, especially with autotools-powered packages, there is a <c>Makefile</c>
-<c>install</c> target which will honour the <c>DESTDIR</c> variable to tell it to
-install to a non-root location. If possible, this should be used:
-</p>
-
-<codesample lang="ebuild">
-    emake DESTDIR="${D}" install || die "Install failed"
-</codesample>
-
-<note>
-<c>emake</c> should be used to parallelise here. Some installs are
-not designed to be parallelised, use <c>emake -j1</c> or <c>make</c>
-if you hit an error.
-</note>
-
-<p>
-Sometimes this will end up installing a few things into strange
-places. If and only if this is the case, the <c>einstall</c> function
-can be used:
-</p>
-
-<codesample lang="ebuild">
-    einstall || die "einstall failed"
-</codesample>
-
-<p>
-It is usually necessary to include additional <c>dodoc</c> statements for the
-<c>README</c>, <c>ChangeLog</c>, etc in these cases.
-</p>
-
-<note>
-There is no need to <c>dodoc</c> <c>COPYING</c>! The license belongs
-to <c>${PORTDIR}/licenses</c>. Sometimes though, you might want to
-install <c>COPYING</c> regardless, if it explains how different
-licenses are applied to different parts of the application, for
-example.
-</note>
-</body>
-</section>
-
-<section>
-<title>Trivial Installs</title>
-<body>
-<p>
-For some packages with no <c>Makefile</c> that only install a small
-number of files, writing a manual install using <c>cp</c> is the
-easiest option. For example, to do a simple install of some (no
-compilation required) themes:
-</p>
-
-<codesample lang="ebuild">
-    dodir /usr/share/foo-styles/
-    cp -R "${S}/" "${D}/" || die "Install failed!"
-</codesample>
-
-<p>
-Or sometimes a combination of <c>insinto</c> and <c>doins</c> (plus related
-functions -- see Install Functions Reference) <d/> the following is based
-upon the <c>sys-fs/udev</c> install:
-</p>
-
-<codesample lang="ebuild">
-src_install() {
-    dobin udevinfo
-    dobin udevtest
-    into /
-    dosbin udev
-    dosbin udevd
-    dosbin udevsend
-    dosbin udevstart
-    dosbin extras/scsi_id/scsi_id
-    dosbin extras/volume_id/udev_volume_id
-
-    exeinto /etc/udev/scripts
-    doexe extras/ide-devfs.sh
-    doexe extras/scsi-devfs.sh
-    doexe extras/cdsymlinks.sh
-    doexe extras/dvb.sh
-
-    insinto /etc/udev
-    newins "${FILESDIR}/udev.conf.post_050" udev.conf
-    doins extras/cdsymlinks.conf
-
-    # For devfs style layout
-    insinto /etc/udev/rules.d/
-    newins etc/udev/gentoo/udev.rules 50-udev.rules
-
-    # scsi_id configuration
-    insinto /etc
-    doins extras/scsi_id/scsi_id.config
-
-    # set up symlinks in /etc/hotplug.d/default
-    dodir /etc/hotplug.d/default
-    dosym ../../../sbin/udevsend /etc/hotplug.d/default/10-udev.hotplug
-
-    # set up the /etc/dev.d directory tree
-    dodir /etc/dev.d/default
-    dodir /etc/dev.d/net
-    exeinto /etc/dev.d/net
-    doexe etc/dev.d/net/hotplug.dev
-
-    doman *.8 || die
-    doman extras/scsi_id/scsi_id.8 || die
-
-    dodoc ChangeLog FAQ HOWTO-udev_for_dev README TODO || die
-    dodoc docs/{overview,udev-OLS2003.pdf,udev_vs_devfs,RFC-dev.d,libsysfs.txt} || die
-    dodoc docs/persistent_naming/* docs/writing_udev_rules/* || die
-
-    newdoc extras/volume_id/README README_volume_id || die
-}
-</codesample>
-
-<p>
-This is, of course, considerably harder to handle than a
-simple <c>Makefile</c> driven install.
-</p>
-</body>
-</section>
-
-<section>
-<title>Other Installs</title>
-<body>
-<p>
-Sometimes, there will be a <c>Makefile</c> that does not
-honour <c>DESTDIR</c> and a non-trivial number of files to install. In
-these situations, it is best to patch the <c>Makefile</c> and contact
-upstream explaining the situation to them.
-</p>
-</body>
-</section>
-
-</chapter>
-</guide>
diff --git a/ebuild-writing/functions/src_prepare/text.xml b/ebuild-writing/functions/src_prepare/text.xml
deleted file mode 100644 (file)
index efda2ca..0000000
+++ /dev/null
@@ -1,61 +0,0 @@
-<?xml version="1.0"?>
-<guide self="ebuild-writing/functions/src_prepare/">
-<chapter>
-<title>src_prepare</title>
-
-<body>
-<table>
-  <tr>
-    <th>Function</th>
-    <ti><c>src_prepare</c></ti>
-  </tr>
-  <tr>
-    <th>Purpose</th>
-    <ti>Prepare source packages and do any necessary patching or fixes.</ti>
-  </tr>
-  <tr>
-    <th>Sandbox</th>
-    <ti>Enabled</ti>
-  </tr>
-  <tr>
-    <th>Privilege</th>
-    <ti>user</ti>
-  </tr>
-  <tr>
-    <th>Called for</th>
-    <ti>ebuild</ti>
-  </tr>
-</table>
-</body>
-
-<section>
-<title>Default <c>src_prepare</c></title>
-<body>
-<p>
-Starting from EAPI="2", the src_prepare function is the appropriate area to perform
-any kind of patching and source code manipulation, instead of src_unpack.
-</p>
-<codesample lang="ebuild">
-src_prepare() {
-       true;
-}
-</codesample>
-</body>
-</section>
-
-<section>
-<title>Sample <c>src_prepare</c></title>
-<body>
-<codesample lang="ebuild">
-src_prepare() {
-    epatch "${FILESDIR}/${PV}/${P}-fix-bogosity.patch"
-    use pam &amp;&amp; epatch "${FILESDIR}/${PV}/${P}-pam.patch"
-
-    sed -i -e 's/"ispell"/"aspell"/' src/defaults.h || die "Sed failed!"
-}
-</codesample>
-</body>
-</section>
-
-</chapter>
-</guide>
diff --git a/ebuild-writing/functions/src_test/text.xml b/ebuild-writing/functions/src_test/text.xml
deleted file mode 100644 (file)
index dd02d4b..0000000
+++ /dev/null
@@ -1,142 +0,0 @@
-<?xml version="1.0"?>
-<guide self="ebuild-writing/functions/src_test/">
-<chapter>
-<title>src_test</title>
-
-<body>
-<table>
-  <tr>
-    <th>Function</th>
-    <ti><c>src_test</c></ti>
-  </tr>
-  <tr>
-    <th>Purpose</th>
-    <ti>Run pre-install test scripts</ti>
-  </tr>
-  <tr>
-    <th>Sandbox</th>
-    <ti>Enabled</ti>
-  </tr>
-  <tr>
-    <th>Privilege</th>
-    <ti>user</ti>
-  </tr>
-  <tr>
-    <th>Called for</th>
-    <ti>ebuild</ti>
-  </tr>
-</table>
-</body>
-
-<section>
-<title>Default <c>src_test</c></title>
-<body>
-<p> From sys-apps/portage-2.1.2.9 </p>
-<codesample lang="ebuild">
-src_test() {
-       if emake -j1 check -n &amp;> /dev/null; then
-               vecho ">>> Test phase [check]: ${CATEGORY}/${PF}"
-               if ! emake -j1 check; then
-                       hasq test $FEATURES &amp;&amp; die "Make check failed. See above for details."
-                       hasq test $FEATURES || eerror "Make check failed. See above for details."
-               fi
-       elif emake -j1 test -n &amp;> /dev/null; then
-               vecho ">>> Test phase [test]: ${CATEGORY}/${PF}"
-               if ! emake -j1 test; then
-                       hasq test $FEATURES &amp;&amp; die "Make test failed. See above for details."
-                       hasq test $FEATURES || eerror "Make test failed. See above for details."
-               fi
-       else
-               vecho ">>> Test phase [none]: ${CATEGORY}/${PF}"
-       fi
-}
-</codesample>
-</body>
-</section>
-
-<section>
-<title>Sample <c>src_test</c></title>
-<body>
-<codesample lang="ebuild">
-src_test() {
-    cd "${S}"/src/testdir
-
-    # Test 49 won't work inside a portage environment
-    sed -i -e 's~test49.out~~g' Makefile
-
-    # Try to run the non-gui tests only
-    make test-nongui \
-            || die "At least one test failed"
-}
-</codesample>
-</body>
-</section>
-
-<section>
-<title>Common <c>src_test</c> Tasks</title>
-<body>
-<p>
-Often the default <c>src_test</c> is fine. Sometimes it is necessary
-to remove certain tests from the list if they cannot be used with a
-portage environment. Reasons for such a failure could include:
-</p>
-
-<ul>
-  <li>Needing to use X.</li>
-  <li>
-    Needing to work with files which are disallowed by the sandbox.
-  </li>
-  <li>Requiring user input (src_test must not be interactive).</li>
-  <li>Requiring root privileges.</li>
-</ul>
-
-<p>
-Usually, removing the relevant test from the <c>Makefile</c>
-using <c>sed</c> or skipping a particular <c>make</c> target is
-sufficient.
-</p>
-
-<note>
-<c>emake</c> should not be used for <c>src_test</c> <d/> trying to
-parallelise tests unless the <c>Makefile</c> was specifically designed
-for this can cause all sorts of strange problems.
-</note>
-
-<p>
-Try to ensure that tests work properly for your ebuild. A good test
-suite is extremely helpful for arch maintainers.
-</p>
-
-</body>
-</section>
-
-<section>
-<title>Skipping Tests</title>
-<body>
-<p>
-Sometimes it is necessary to skip tests entirely. This can be done
-using a dummy <c>src_test</c> function:
-</p>
-
-<codesample lang="ebuild">
-src_test() {
-    # Tests don't even remotely work inside portage
-    true
-}
-</codesample>
-
-<p>
-Another option would be to set <c>RESTRICT="test"</c> in the ebuild.
-</p>
-
-<note>
-If upstream provide a test suite which doesn't work, consider talking
-to them about getting it fixed. A broken test suite is worse than no
-test suite at all, since we are unable to tell whether a test failure
-indicates a genuine fault.
-</note>
-</body>
-</section>
-
-</chapter>
-</guide>
diff --git a/ebuild-writing/functions/src_unpack/autopackage/text.xml b/ebuild-writing/functions/src_unpack/autopackage/text.xml
deleted file mode 100644 (file)
index dfde1c5..0000000
+++ /dev/null
@@ -1,42 +0,0 @@
-<?xml version="1.0"?>
-<guide self="ebuild-writing/functions/src_unpack/autopackage/">
-<chapter>
-<title>Autopackage</title>
-
-<body>
-<p>
-If a package is only supplied in autopackage format, you must not add
-it to the tree. If a package is supplied in autopackage format and
-some other sane standard format (for example a source tarball), use
-the other format only.
-</p>
-
-<p>
-Autopackage packages are totally unsuitable for Gentoo systems for a
-large number of reasons:
-</p>
-
-<ul>
-  <li>
-  To even unpack the package, you must run arbitrary code supplied by an untrusted source.
-  </li>
-  <li>They install directly to the live filesystem.</li>
-  <li>Their intrinsic dependency resolver is broken.</li>
-  <li>They do not support the filesystem layout used by Gentoo.</li>
-  <li>They do not support configuration protection.</li>
-  <li>They can clobber arbitrary files on uninstall.</li>
-  <li>The linking mechanism used is insufficiently flexible.</li>
-  <li>
-  The entire format is completely unportable and highly tied to x86
-  Linux systems.
-  </li>
-</ul>
-
-<p>
-Upstream are aware of these issues and have no desire to fix them <d/>
-indeed, they pass off some of their most broken behaviour as
-'features'.
-</p>
-</body>
-</chapter>
-</guide>
diff --git a/ebuild-writing/functions/src_unpack/cvs-sources/text.xml b/ebuild-writing/functions/src_unpack/cvs-sources/text.xml
deleted file mode 100644 (file)
index 4c51550..0000000
+++ /dev/null
@@ -1,182 +0,0 @@
-<?xml version="1.0"?>
-<guide self="ebuild-writing/functions/src_unpack/cvs-sources/">
-<chapter>
-<title>CVS Sources</title>
-
-<body>
-<p>
-Rather than working with a source tarball, it is possible to use
-upstream's CVS server directly. This can be useful when there is a
-need to test unreleased snapshots on a regular basis.
-</p>
-</body>
-
-<section>
-<title>Disadvantages of CVS Sources</title>
-<body>
-
-<p>
-Note that CVS ebuilds should <b>not</b> generally be added to the tree
-(except under <c>package.mask</c>) for the following reasons:
-</p>
-
-<ul>
-  <li>
-  Upstream CVS servers tend to be far less reliable than our mirroring
-  system.
-  </li>
-  <li>
-  CVS ebuilds create a very heavy server load <d/> not only is CVS not
-  mirrored, but allowing a CVS checkout is considerably more work for
-  a server than simply serving up a file via HTTP or FTP.
-  </li>
-  <li>
-  Many users who are behind strict firewalls cannot use CVS.
-  </li>
-</ul>
-
-<p>
-It is safer to make a snapshot instead. For example, vim snapshots are made using:
-</p>
-
-<pre>
-$ cvs -z3 -d :pserver:anonymous@cvs.sourceforge.net:/cvsroot/vim export -r HEAD vim
-</pre>
-</body>
-</section>
-
-<section>
-<title>Disadvantages of CVS Live Sources</title>
-<body>
-
-<p>
-CVS ebuilds which work against CVS <c>HEAD</c> rather than a specific
-date or revision are even worse candidates for tree inclusion:
-</p>
-
-<ul>
-  <li>
-  You can never be sure whether upstream's CVS will actually
-  build at any given point; which will most likely cause QA issues.
-  </li>
-  <li>
-  It is extremely difficult to track down bugs when you cannot install
-  the same version of a package as the reporter.
-  </li>
-  <li>
-  Many upstream package maintainers tend to get upset if people aren't
-  using a specific released version.
-  </li>
-</ul>
-
-</body>
-</section>
-
-<section>
-<title>Using CVS Sources</title>
-<body>
-
-<p>
-To use a CVS source, <c>cvs.eclass</c> must be inherited, and then a
-number of variables must be set. The following variables are often
-useful:
-</p>
-
-<table>
-  <tr>
-    <th>Variable</th>
-    <th>Purpose</th>
-    <th>Example</th>
-  </tr>
-  <tr>
-    <ti><c>ECVS_SERVER</c></ti>
-    <ti>Server and path</ti>
-    <ti><c>"cvs.sourceforge.net:/cvsroot/vim"</c></ti>
-  </tr>
-  <tr>
-    <ti><c>ECVS_MODULE</c></ti>
-    <ti>Module</ti>
-    <ti><c>"vim"</c></ti>
-  </tr>
-  <tr>
-    <ti><c>ECVS_BRANCH</c></ti>
-    <ti>Branch</ti>
-    <ti><c>"HEAD"</c></ti>
-  </tr>
-  <tr>
-    <ti><c>ECVS_AUTH</c></ti>
-    <ti>Auth method</ti>
-    <ti><c>"ext"</c></ti>
-  </tr>
-  <tr>
-    <ti><c>ECVS_USER</c></ti>
-    <ti>Username</ti>
-    <ti><c>"anoncvs"</c></ti>
-  </tr>
-  <tr>
-    <ti><c>ECVS_PASS</c></ti>
-    <ti>Password</ti>
-    <ti><c>""</c></ti>
-  </tr>
-  <tr>
-    <ti><c>ECVS_TOPDIR</c></ti>
-    <ti>Unpack location</ti>
-    <ti><c>"${DISTDIR}/cvs-src/${ECVS_MODULE}"</c></ti>
-  </tr>
-</table>
-
-<p>
-See the eclass itself for the full range of options. To perform the
-actual checkout, use the <c>cvs_src_unpack</c> function.
-</p>
-
-<p>
-Here's a simple example, based upon the CVS options in vim.eclass:
-</p>
-
-<codesample lang="ebuild">
-inherit cvs
-
-SRC_URI=""
-
-src_unpack() {
-    ECVS_SERVER="cvs.sourceforge.net:/cvsroot/vim"
-    ECVS_USER="anonymous"
-    ECVS_PASS=""
-    ECVS_AUTH="pserver"
-    if [[ $(get_major_version ) -ge 7 ]] ; then
-        ECVS_MODULE="vim7"
-    else
-        ECVS_MODULE="vim"
-    fi
-    ECVS_TOP_DIR="${DISTDIR}/cvs-src/${ECVS_MODULE}"
-    cvs_src_unpack
-}
-</codesample>
-
-<p>
-Here's another approach, based upon the <c>emacs-cvs</c> ebuild, which
-relies upon the default <c>src_unpack</c> provided in the eclass; this
-approach is simpler but less flexible:
-</p>
-
-<codesample lang="ebuild">
-inherit cvs
-
-ECVS_AUTH="ext"
-CVS_RSH="ssh"
-ECVS_SERVER="savannah.gnu.org:/cvsroot/emacs"
-ECVS_MODULE="emacs"
-ECVS_BRANCH="emacs-unicode-2"
-ECVS_USER="anoncvs"
-ECVS_PASS=""
-ECVS_CVS_OPTIONS="-dP"
-
-# ...and so on. No src_unpack() is specified.
-</codesample>
-
-</body>
-</section>
-
-</chapter>
-</guide>
diff --git a/ebuild-writing/functions/src_unpack/deb-sources/text.xml b/ebuild-writing/functions/src_unpack/deb-sources/text.xml
deleted file mode 100644 (file)
index bdbadb4..0000000
+++ /dev/null
@@ -1,12 +0,0 @@
-<?xml version="1.0"?>
-<guide self="ebuild-writing/functions/src_unpack/deb-sources/">
-<chapter>
-<title>Debian Sources</title>
-
-<body>
-<todo>
-from vapier: we dont have to 'handle' these because all debian packages have a source tarball ... the .deb format is pretty simple though, it's managed by the 'ar' utility from binutils. you can unpack a .deb by simply doing ar x blah.deb ... this will give you three files: debian-binary: plain text file which just contains version number of the .deb format control.tar.gz: a few files which control installing/verifying of package data.tar.gz: all the compiled files ... you could just extract it to /
-</todo>
-</body>
-</chapter>
-</guide>
diff --git a/ebuild-writing/functions/src_unpack/epatch/text.xml b/ebuild-writing/functions/src_unpack/epatch/text.xml
deleted file mode 100644 (file)
index b12a77b..0000000
+++ /dev/null
@@ -1,155 +0,0 @@
-<?xml version="1.0"?>
-<guide self="ebuild-writing/functions/src_unpack/epatch/">
-<chapter>
-<title>Patching with epatch</title>
-
-<body>
-<p>
-The canonical way of applying patches in ebuilds is to
-use <c>epatch</c> (from <c>eutils.eclass</c>, which you must make sure
-to import!) inside <c>src_unpack</c>. This function automatically
-handles <c>-p</c> levels, <c>gunzip</c> and so on as necessary.
-</p>
-
-<p>
-Note that distributing modified tarballs rather than a vanilla tarball
-and patches is <e>highly</e> discouraged.
-</p>
-</body>
-
-<section>
-<title>Basic <c>epatch</c></title>
-<body>
-
-<p>
-In its simplest form, <c>epatch</c> takes a single filename and
-applies that patch. It will automatically <c>die</c> if the apply
-fails. The following is taken from <c>app-misc/detox</c>:
-</p>
-
-<codesample lang="ebuild">
-src_unpack() {
-    unpack ${A}
-    cd "${S}"
-    epatch "${FILESDIR}/${P}-destdir.patch"
-    epatch "${FILESDIR}/${P}-parallel_build.patch"
-}
-</codesample>
-
-<p>
-For larger patches, using <c>mirror://gentoo/</c> rather
-than <c>files/</c> is more appropriate. In these situations, it is
-usually best to <c>bzip2</c> the patch in question (as opposed to
-<c>files/</c> patches, which must not be compressed). For example,
-from <c>app-admin/showconsole</c>:
-</p>
-
-<codesample lang="ebuild">
-src_unpack() {
-    unpack ${A}
-    cd "${S}"
-    epatch "${WORKDIR}/${P}-suse-update.patch.bz2"
-    epatch "${FILESDIR}/${PV}-no-TIOCGDEV.patch"
-}
-</codesample>
-<p>As stated before, if you are using EAPI >=2, you should apply the patches in the <uri link="::ebuild-writing/functions/src_prepare">src_prepare</uri> function</p>
-<codesample lang="ebuild">
-src_prepare() {
-       epatch "${WORKDIR}/${P}-suse-update.patch.bz2"
-       epatch "${FILESDIR}/${PV}-no-TIOCGDEV.patch"
-}
-</codesample>
-
-<p>
-Remember to add the patch to <c>SRC_URI</c>.
-</p>
-</body>
-
-<subsection>
-<title>CVS Keyword Lines and Patches</title>
-<body>
-<p>
-If your patch includes any changes to CVS <c>$Id: $</c>
-(or <c>$Header: $</c>, or <c>$Date: $</c>) lines, it cannot be
-distributed under <c>files/</c>, since CVS will clobber the patch when
-you commit. In these situations, either remove this hunk of the patch
-manually, or mirror the file.
-</p>
-</body>
-</subsection>
-
-</section>
-
-<section>
-<title>Multiple Patches with <c>epatch</c></title>
-<body>
-
-<p>
-epatch can also apply multiple patches (which can be selectively based
-upon arch) from a single directory. This can be useful if upstream
-have releases that need more patches.
-</p>
-
-<p>
-A simple example:
-</p>
-
-<codesample lang="ebuild">
-src_unpack() {
-    unpack ${A}
-    cd "${S}"
-    EPATCH_SOURCE="${WORKDIR}/patches" EPATCH_SUFFIX="patch" \
-        EPATCH_FORCE="yes" epatch
-}
-</codesample>
-
-<p>
-Here, one of the <c>SRC_URI</c> components is a tarball containing
-many patches with file extension <c>.patch</c>.
-</p>
-
-<p>
-Variables which may be defined include:
-</p>
-
-<table>
-  <tr>
-    <th>Variable</th>
-    <th>Purpose</th>
-  </tr>
-  <tr>
-    <ti><c>EPATCH_SOURCE</c></ti>
-    <ti>Specifies the directory in which epatch looks for patches.</ti>
-  </tr>
-  <tr>
-    <ti><c>EPATCH_SUFFIX</c></ti>
-    <ti>File extension for patches.</ti>
-  </tr>
-  <tr>
-    <ti><c>EPATCH_OPTS</c></ti>
-    <ti>Default options to <c>patch</c>.</ti>
-  </tr>
-  <tr>
-    <ti><c>EPATCH_EXCLUDE</c></ti>
-    <ti>List of patches to exclude.</ti>
-  </tr>
-  <tr>
-    <ti><c>EPATCH_FORCE</c></ti>
-    <ti>
-    Force epatch to apply patches even if they do not follow the
-    canonical naming form (set to <c>yes</c>).
-    </ti>
-  </tr>
-</table>
-
-<p>
-Bulk patches should be named in the form
-<c>??_${ARCH}_foo.${EPATCH_SUFFIX}</c>. If they are
-not, <c>EPATCH_FORCE="yes"</c> must be set. To apply a patch on <c>all</c>
-archs, use all for the <c>${ARCH}</c> part.
-</p>
-
-</body>
-</section>
-</chapter>
-</guide>
diff --git a/ebuild-writing/functions/src_unpack/other-formats/text.xml b/ebuild-writing/functions/src_unpack/other-formats/text.xml
deleted file mode 100644 (file)
index 3647c80..0000000
+++ /dev/null
@@ -1,53 +0,0 @@
-<?xml version="1.0"?>
-<guide self="ebuild-writing/functions/src_unpack/other-formats/">
-<chapter>
-<title>Other Archive Formats</title>
-
-<body>
-<p>
-There are a variety of other archive formats which you may encounter.
-Instructions for some of them are detailed below:
-</p>
-</body>
-
-<section>
-<title>Zip Files</title>
-<body>
-
-<p>
-If a package is supplied as a .zip file, you should:
-</p>
-
-<ul>
-   <li><c>DEPEND</c> upon <c>app-arch/unzip</c></li>
-   <li>Use <c>unpack</c> as normal</li>
-</ul>
-
-</body>
-</section>
-
-<section>
-<title>Shar Files</title>
-<body>
-<p>
-If a package is supplied as a <c>.shar</c> file, you should repackage it locally
-into a <c>.tar.bz2</c>. It may also be useful to ask upstream to use a friendlier
-package format <d/> however, if they ship <c>.shar</c>, chances are they haven't
-done a release in at least ten years.
-</p>
-</body>
-</section>
-
-<section>
-<title>RAR Files</title>
-<body>
-
-<p>
-<c>.rar</c> files must be repackaged locally into a <c>.tar.bz2</c> file.
-</p>
-
-</body>
-</section>
-
-</chapter>
-</guide>
diff --git a/ebuild-writing/functions/src_unpack/rpm-sources/text.xml b/ebuild-writing/functions/src_unpack/rpm-sources/text.xml
deleted file mode 100644 (file)
index 1eff743..0000000
+++ /dev/null
@@ -1,123 +0,0 @@
-<?xml version="1.0"?>
-<guide self="ebuild-writing/functions/src_unpack/rpm-sources/">
-<chapter>
-<title>RPM Sources</title>
-
-<body>
-<p>
-If a package is supplied as an .rpm file, you should:
-</p>
-
-<codesample lang="ebuild">
-inherit rpm
-</codesample>
-
-<p>
-If you don't need to do anything in the unpack phase, then you are
-finished as the <c>rpm.eclass</c> exports a default <c>src_unpack</c>
-that will unpack the RPM files.
-</p>
-
-<p>
-If you do need to apply patches then override <c>src_unpack</c> in a
-manner such as:
-</p>
-
-<codesample lang="ebuild">
-src_unpack () {
-    rpm_src_unpack ${A}
-    cd "${S}"
-
-    use ssl &amp;&amp; epatch "${FILESDIR}/${PV}/${P}-ssl.patch"
-}
-</codesample>
-
-<note>
-<c>${A}</c> can contain non-rpm files since the rpm eclass will call
-the normal <c>unpack</c> function for files that are not in the RPM
-format.
-</note>
-</body>
-
-<section>
-<title>Notes on Using <c>rpm.eclass</c></title>
-<body>
-
-<p>
-There are two ways to unpack a rpm file <d/> using
-the <c>rpmoffset</c> program from <c>rpm2targz</c> and <c>cpio</c>, or
-by using <c>rpm2cpio</c> from <c>app-arch/rpm</c>. Normally, for
-unpacking an RPM file, installing the entire RPM application is
-overkill. Because of this, the eclass will only use <c>rpm2cpio</c>
-if <c>rpm</c> is already installed on the system. If you want to force
-the eclass to only use the RPM offset method, set
-<c>USE_RPMOFFSET_ONLY=1</c>.
-</p>
-
-<p>
-Another issue that might arise is that <c>rpmoffset</c> and cpio are not able
-to unpack the RPM file correctly. If this occurs, then you need to add
-<c>app-arch/rpm</c> to the <c>DEPEND</c> variable so
-that <c>rpm2cpio</c> will be used instead.
-</p>
-
-</body>
-</section>
-
-<section>
-<title>Example RPM Handling</title>
-<body>
-
-<p>
-Here is an ebuild snippet that is based upon the fetchmail source RPM
-from SuSE 9.2. The ebuild snippet is complete enough to work with the
-<c>ebuild unpack</c> command. The ebuild will download the source file from
-the OSU SuSE mirror, unpack the file and apply the included
-patches. The filename should be <c>suse-fetchmail-6.2.5.54.1.ebuild</c>.
-</p>
-
-<codesample lang="ebuild">
-# Copyright 1999-2005 Gentoo Foundation
-# Distributed under the terms of the GNU General Public License v2
-# $Header: $
-
-inherit eutils versionator rpm
-
-MY_PV=$(replace_version_separator 3 '-')
-MY_P=fetchmail-${MY_PV}
-
-SRC_URI="http://suse.osuosl.org/suse/i386/9.2/suse/src/${MY_P}.src.rpm"
-DESCRIPTION="SuSE 9.2 Fetchmail Source Package"
-HOMEPAGE="http://www.suse.com"
-LICENSE="GPL-2 public-domain"
-SLOT="0"
-KEYWORDS="-*"
-IUSE=""
-
-RESTRICT="mirror"
-
-# Need to test if the file can be unpacked with rpmoffset and cpio
-# If it can't then set:
-
-#DEPEND="app-arch/rpm"
-
-# To force the use of rpmoffset and cpio instead of rpm2cpio from
-# app-arch/rpm, then set the following:
-
-#USE_RPMOFFSET_ONLY=1
-
-S=${WORKDIR}/fetchmail-$(get_version_component_range 1-3)
-
-src_unpack () {
-    rpm_src_unpack ${A}
-    cd "${S}"
-    EPATCH_SOURCE="${WORKDIR}" EPATCH_SUFFIX="patch" \
-        EPATCH_FORCE="yes" epatch
-}
-</codesample>
-
-</body>
-</section>
-
-</chapter>
-</guide>
diff --git a/ebuild-writing/functions/src_unpack/svn-sources/text.xml b/ebuild-writing/functions/src_unpack/svn-sources/text.xml
deleted file mode 100644 (file)
index c23ff7c..0000000
+++ /dev/null
@@ -1,109 +0,0 @@
-<?xml version="1.0"?>
-<guide self="ebuild-writing/functions/src_unpack/svn-sources/">
-<chapter>
-<title>Subversion Sources</title>
-
-<body>
-<p>
-As with CVS, an eclass exists for working directly with upstream
-Subversion repositories. See <uri link="eclass-reference/subversion.eclass/"/>
-for a full list of functions and variables. Also see
-the <uri link="::ebuild-writing/functions/src_unpack/cvs-sources"/> 
-ection.
-</p>
-</body>
-
-<section>
-<title>Disadvantages of Subversion Sources</title>
-<body>
-
-<p>
-Note that Subversion ebuilds should <b>not</b> generally be added to
-the tree (except under <c>package.mask</c>) for much the same reasons
-that live CVS ebuilds should not (see
-<uri link="::ebuild-writing/functions/src_unpack/cvs-sources#Disadvantages of CVS Sources"/>).
-Indeed, there should be even less impetus to add a live Subversion ebuild than a live CVS ebuild, as
-Subversion checkouts are roughly a factor of five larger than an
-equivalent CVS checkout.
-</p>
-
-<p>
-It is safer (and better for the user) to make a snapshot instead. For
-example, <c>gentoo-syntax</c> snapshots could be made using:
-</p>
-
-<pre>
-$ svn export svn://svn.berlios.de/svnroot/repos/gentoo-syntax -r HEAD gentoo-syntax
-</pre>
-</body>
-</section>
-
-<section>
-<title>Using Subversion Sources</title>
-<body>
-
-<p>
-To use a Subversion source, <c>subversion.eclass</c> must be
-inherited, and then at least <c>ESVN_REPO_URI</c> must be set. The
-following variables are also noteworthy:
-</p>
-
-<table>
-  <tr>
-    <th>Variable</th>
-    <th>Purpose</th>
-    <th>Example</th>
-  </tr>
-  <tr>
-    <ti><c>ESVN_REPO_URI</c></ti>
-    <ti>Server and path (http, https, svn)</ti>
-    <ti><c>"svn://svn.example.com/foobar/trunk"</c></ti>
-  </tr>
-  <tr>
-    <ti><c>ESVN_STORE_DIR</c></ti>
-    <ti>Unpack location</ti>
-    <ti><c>ESVN_STORE_DIR="${DISTDIR}/svn-src"</c></ti>
-  </tr>
-  <tr>
-    <ti><c>ESVN_PROJECT</c></ti>
-    <ti>Project name of ebuild</ti>
-    <ti><c>ESVN_PROJECT="${PN/-svn}"</c></ti>
-  </tr>
-  <tr>
-    <ti><c>ESVN_BOOTSTRAP</c></ti>
-    <ti>Bootstrap command or script</ti>
-    <ti><c>ESVN_BOOTSTRAP="autogen.sh"</c></ti>
-  </tr>
-  <tr>
-    <ti><c>ESVN_PATCHES</c></ti>
-    <ti>Patches to apply during bootstrap</ti>
-    <ti><c>ESVN_PATCHES="${FILESDIR}/*.patch"</c></ti>
-  </tr>
-</table>
-
-<p>
-See the eclass itself and <uri link="eclass-reference/subversion.eclass/"/>
-for the full range of options. To perform the actual checkout, use
-the <c>subversion_src_unpack</c> function, which calls
-both <c>subversion_svn_fetch</c> and <c>subversion_bootstrap</c>
-itself.
-</p>
-
-<p>
-Here is a simple example, based upon the Subversion options in
-<c>litu-svn-20040902.ebuild</c>; this approach is sufficient for most
-Subversion ebuilds:
-</p>
-
-<codesample lang="ebuild">
-inherit subversion
-
-ESVN_REPO_URI="http://tao.uab.es/ion/svn/libtu/trunk"
-ESVN_PROJECT="libtu-snapshot"
-</codesample>
-
-</body>
-</section>
-
-</chapter>
-</guide>
diff --git a/ebuild-writing/functions/src_unpack/text.xml b/ebuild-writing/functions/src_unpack/text.xml
deleted file mode 100644 (file)
index 453ecef..0000000
+++ /dev/null
@@ -1,104 +0,0 @@
-<?xml version="1.0"?>
-<guide self="ebuild-writing/functions/src_unpack/">
-<chapter>
-<title>src_unpack</title>
-
-<body>
-<table>
-  <tr>
-    <th>Function</th>
-    <ti><c>src_unpack</c></ti>
-  </tr>
-  <tr>
-    <th>Purpose</th>
-    <ti>Extract source packages and do any necessary patching or fixes.</ti>
-  </tr>
-  <tr>
-    <th>Sandbox</th>
-    <ti>Enabled</ti>
-  </tr>
-  <tr>
-    <th>Privilege</th>
-    <ti>user</ti>
-  </tr>
-  <tr>
-    <th>Called for</th>
-    <ti>ebuild</ti>
-  </tr>
-</table>
-</body>
-
-<section>
-<title>Default <c>src_unpack</c></title>
-<body>
-<codesample lang="ebuild">
-src_unpack() {
-    if [ "${A}" != "" ]; then
-        unpack ${A}
-    fi
-}
-</codesample>
-</body>
-</section>
-
-<section>
-<title>Sample <c>src_unpack</c></title>
-<body>
-<codesample lang="ebuild">
-src_unpack() {
-    unpack ${A}
-    cd "${S}"
-
-    epatch "${FILESDIR}/${PV}/${P}-fix-bogosity.patch"
-    use pam &amp;&amp; epatch "${FILESDIR}/${PV}/${P}-pam.patch"
-
-    sed -i -e 's/"ispell"/"aspell"/' src/defaults.h || die "Sed failed!"
-}
-</codesample>
-<note>
-When using EAPI >=2, you should use the <uri link="::ebuild-writing/functions/src_prepare">src_prepare</uri> function to apply patches or alter any of the source files, instead of the src_unpack.
-</note>
-
-</body>
-</section>
-
-<section>
-<title>Unpacking Tarballs</title>
-<body>
-<p>
-The <c>unpack</c> function should be used to unpack tarballs, compressed
-files and so on. Do not use <c>tar</c>, <c>gunzip</c> etc. manually.
-</p>
-
-<p>
-The <c>${A}</c> variable contains all of the <c>SRC_URI</c> components, except
-for any which are excluded by USE-based conditionals inside <c>SRC_URI</c>
-itself. If multiple archives require unpacking in a particular order it is
-usually simpler to avoid working with <c>${A}</c>.
-</p>
-</body>
-</section>
-
-<section>
-<title><c>src_unpack</c> Actions</title>
-<body>
-<p>
-The following subsections cover different topics which often occur when writing
-<c>src_unpack</c> functions.
-</p>
-
-<contentsTree/>
-</body>
-</section>
-
-</chapter>
-
-<include href="epatch/"/>
-<include href="cvs-sources/"/>
-<include href="svn-sources/"/>
-<include href="tla-sources/"/>
-<include href="rpm-sources/"/>
-<include href="deb-sources/"/>
-<include href="autopackage/"/>
-<include href="other-formats/"/>
-</guide>
diff --git a/ebuild-writing/functions/src_unpack/tla-sources/text.xml b/ebuild-writing/functions/src_unpack/tla-sources/text.xml
deleted file mode 100644 (file)
index 97a8b40..0000000
+++ /dev/null
@@ -1,12 +0,0 @@
-<?xml version="1.0"?>
-<guide self="ebuild-writing/functions/src_unpack/tla-sources/">
-<chapter>
-<title>Arch Sources</title>
-
-<body>
-<todo>
-Anyone want to write this? You can probably mostly copy the CVS Sources and Subversion Sources chapters.
-</todo>
-</body>
-</chapter>
-</guide>
diff --git a/ebuild-writing/functions/text.xml b/ebuild-writing/functions/text.xml
deleted file mode 100644 (file)
index d634ad7..0000000
+++ /dev/null
@@ -1,58 +0,0 @@
-<?xml version="1.0"?>
-<guide self="ebuild-writing/functions/">
-<chapter>
-<title>Ebuild Functions</title>
-
-<body>
-<p>
-When installing packages from source, the function call order is <c>pkg_setup</c>,
-<c>src_unpack</c>, <c>src_prepare</c>, <c>src_compile</c>, <c>src_test</c> (optional, <c>FEATURES="test"</c>),
-<c>src_install</c>, <c>pkg_preinst</c>, <c>pkg_postinst</c>. When installing packages
-from a binary, the function call order is <c>pkg_setup</c>, <c>pkg_preinst</c>,
-<c>pkg_postinst</c>.
-</p>
-
-<figure short="How the ebuild functions are processed" link="diagram.png"/>
-
-<p>
-The <c>pkg_prerm</c> and <c>pkg_postrm</c> functions are called when uninstalling a
-package. The <c>pkg_config</c> function is used for any special package
-configuration <d/> it is only run when explicitly requested by the user. The
-<c>pkg_nofetch</c> function is used when a <c>RESTRICT="fetch"</c> package needs to
-obtain some <c>SRC_URI</c> components.
-</p>
-
-<p>
-Between the transition from <c>pkg_preinst</c> to <c>pkg_postinst</c>, files are
-copied over to the live filesystem from the sandboxed temporary installation
-location, and Portage records digests of the files installed.
-</p>
-
-<p>
-When testing or debugging, you can instruct Portage to execute a specific function
-from an ebuild by using the <c>ebuild</c> command, see the <c>ebuild(1)</c> manual
-page for further information.
-</p>
-</body>
-
-<section>
-<title>Contents</title>
-<body>
-<contentsTree/>
-</body>
-</section>
-</chapter>
-
-<include href="pkg_nofetch/"/>
-<include href="pkg_setup/"/>
-<include href="src_unpack/"/>
-<include href="src_prepare/"/>
-<include href="src_compile/"/>
-<include href="src_test/"/>
-<include href="src_install/"/>
-<include href="pkg_preinst/"/>
-<include href="pkg_postinst/"/>
-<include href="pkg_prerm/"/>
-<include href="pkg_postrm/"/>
-<include href="pkg_config/"/>
-</guide>
diff --git a/ebuild-writing/messages/text.xml b/ebuild-writing/messages/text.xml
deleted file mode 100644 (file)
index 2bb348a..0000000
+++ /dev/null
@@ -1,163 +0,0 @@
-<?xml version="1.0"?>
-<guide self="ebuild-writing/messages/">
-<chapter>
-<title>Messages</title>
-
-<body>
-<p>
-Sometimes it is necessary to display messages for the user. This can be for
-errors, post-install help messages, pre-install warnings or simply to notify the
-user of what's going on. It is considered good form to display a message
-before any particularly long and silent task is carried out, for example (and it
-also helps cut down on bogus "compiling foo froze!" bugs).
-</p>
-
-<note>
-It is a policy violation to use any of these functions to display a line
-of characters (a banner header). The use of colours and special leading
-characters provided by these functions is sufficient to make a message stand
-out.
-</note>
-
-<p>
-In all cases, assume that the user's terminal is no wider than 79 columns, and
-that the <c>elog</c>,<c>einfo</c>, <c>ewarn</c> and <c>eerror</c> functions will 
-occupy 4 columns with their fancy leading markers.
-</p>
-
-</body>
-
-<section>
-<title>Information Messages</title>
-<body>
-
-<p>
-There are a number of functions available to assist here. The `echo` bash
-internal is the simplest <d/> it simply displays its parameters as a message.
-</p>
-
-<p>
-The <c>elog</c> function can be used to display an informational message which is
-meant to 'stand out' and is logged by the elog functionality in Portage 2.1 and
-Paludis 0.6 or newer.  On a colour terminal, the message provided will be prefixed
-with a green asterisk.  On earlier versions, elog behaves just like einfo.
-</p>
-
-<codesample lang="ebuild">
-pkg_postinst() {
-    elog "You will need to set up your /etc/foo/foo.conf file before"
-    elog "running foo for the first time. For details, please see the"
-    elog "foo.conf(5) manual page."
-}
-</codesample>
-
-
-<p>
-The <c>einfo</c> function can be used to display an informational message which is
-meant to 'stand out'. On a colour terminal, the message provided will be
-prefixed with a green asterisk. einfo messages go to the INFO elog class which is not
-logged by default.
-</p>
-
-<codesample lang="ebuild">
-src_compile() {
-    einfo "Starting a silent compile that takes hours."
-    ./build
-}
-</codesample>
-
-</body>
-</section>
-
-<section>
-<title>Warning Messages</title>
-<body>
-
-<p>
-The <c>ewarn</c> function is similar, but displays a yellow asterisk. This should be
-used for warning messages rather than information.
-</p>
-
-</body>
-</section>
-
-<section>
-<title>Error Messages</title>
-<body>
-
-<p>
-The <c>eerror</c> function displays a red star, and is used for displaying error
-messages. It should almost always be followed by a <c>die</c> call. This function
-is mainly used for displaying additional error details before bailing out.
-</p>
-
-</body>
-</section>
-
-<section>
-<title>QA warnings</title>
-<body>
-
-<p>
-       The <c>eqawarn</c> function can be used by eclass authors to notify ebuild writers about
-       deprecated functionality. eqawarn is defined in eutils. Portage doesn't log the qa message
-       class by default so users don't get annoyed by seeing messages they can't do much about.
-</p>
-
-</body>
-</section>
-
-<section>
-<title>Message function reference</title>
-<body>
-
-<p>
-See <uri link="::function-reference/message-functions/"/> for a full list of functions.
-</p>
-
-</body>
-</section>
-
-<section>
-<title>Good and Bad Messages</title>
-<body>
-
-<p>
-Here is an example of a bad message:
-</p>
-
-<codesample lang="ebuild">
-i=10
-while ((i--)) ; do
-    ewarn "PLEASE UPDATE TO YOUR PACKAGE TO USE linux-info.eclass"
-done
-</codesample>
-
-<ul>
-  <li>Displaying the same message repeatedly is excessive.</li>
-  <li>The uppercase is excessive.</li>
-  <li>The bad English looks unprofessional.</li>
-  <li>
-  The message will only confuse the end user and will not help them work out
-  whether they have a problem and how to solve it if they do.
-  </li>
-</ul>
-
-<p>
-It would be better written as:
-</p>
-
-<codesample lang="ebuild">
-ewarn "The 'frozbinate' function provided by eutils.eclass is deprecated"
-ewarn "in favour of frozbinate.eclass, but this package has not been"
-ewarn "updated yet. If this is a package from the main tree, please check"
-ewarn "http://bugs.gentoo.org/ and file a bug if there is not one already."
-ewarn "If this is your own package, please read the comments in the"
-ewarn "frozbinate eclass for instructions on how to convert."
-</codesample>
-
-</body>
-</section>
-
-</chapter>
-</guide>
diff --git a/ebuild-writing/misc-files/changelog/text.xml b/ebuild-writing/misc-files/changelog/text.xml
deleted file mode 100644 (file)
index 85ec332..0000000
+++ /dev/null
@@ -1,106 +0,0 @@
-<?xml version="1.0"?>
-<guide self="ebuild-writing/misc-files/changelog/">
-<chapter>
-<title>ChangeLog</title>
-
-<body>
-<p>
-The <c>ChangeLog</c> should be used to record all non-trivial changes
-to ebuilds, including <e>keywording changes</e>. The echangelog tool
-should be used to create <c>ChangeLog</c> entries — the format of a
-<c>ChangeLog</c> is now defined as "whatever <c>echangelog</c>
-creates".
-</p>
-
-<p>
-You should include references to any relevant bugs. The standard
-format for doing this is via the phrase <c>bug #20600</c> — this
-format (with the hash sign included) is recognised via
-<uri link="http://packages.gentoo.org">packages.gentoo.org</uri> and
-similar tools. When including user-submitted ebuilds or patches, you
-should credit the user with their full name and email address (or
-whatever they use to identify themselves on bugzilla <d/> some users
-prefer to be known only by a nickname).
-</p>
-
-<p>
-If you are changing keywords, make sure you clearly state what
-keywords you add or remove. "Marked stable" is a nuisance for
-architecture teams, even if there was only one keyword in the ebuild
-at the time. "Stable on all archs" isn't generally any better (and
-should you really be stabling on all archs?) — do you mean "all", or
-"all the ones that are currently keyworded"? A list like "x86 sparc
-mips" is much more useful.
-</p>
-
-<p>
-A typical <c>ChangeLog</c> snippet might look like the following:
-</p>
-
-<pre>
-    *vim-6.3.068 (25 Mar 2005)
-
-      25 Mar 2005; Ciaran McCreesh &lt;ciaranm@gentoo.org&gt; +vim-6.3.068.ebuild:
-      New release. Fixes bug #79981, bug #81289, bug #83383, bug #83416, bug
-      #83565, bug #85758, upstream patches up to 6.3.068.
-
-      22 Mar 2005; Aron Griffis &lt;agriffis@gentoo.org&gt; vim-6.3-r4.ebuild:
-      Stable on alpha
-</pre>
-
-<section>
-<title>Writing correct ChangeLog messages</title>
-<body>
-<note>
-It is <b>very</b> important that your <c>cvs commit</c> messages are
-also informative to aid the QA team or architecture teams as well as
-other developers if they are trying to troubleshoot issues which are
-known to not have occured in previous versions of ebuilds, for
-example. If your ChangeLog message is concise there is usually nothing
-wrong with using it as the <c>cvs commit</c> message.
-</note>
-
-<p>
-Your message should explain what specifically you changed and, if
-relevant, why. You don't need to write an essay or even a complete
-sentence (<c>ChangeLog</c> messages, however, are required to be in
-'proper' English so no <c>fixed that bug kthx Bob</c> messages —
-please do use punctuation), so long as it is easily understandable and
-(preferably) greppable. Bad and good examples, all of which are based
-upon real messages:
-</p>
-
-<ul>
-  <li><b>BAD:</b> Changed keywords</li>
-  <li><e>GOOD:</e> Added ~x86 keyword</li>
-</ul>
-
-<ul>
-  <li><b>BAD:</b> Stable</li>
-  <li><e>GOOD:</e> Stable on x86, sparc, mips</li>
-</ul>
-
-<ul>
-  <li><b>BAD:</b> Fix stuff</li>
-  <li><e>GOOD:</e> Fix USE=foo logic error</li>
-</ul>
-
-<ul>
-  <li><b>BAD:</b> .</li>
-  <li><e>GOOD:</e> Purge old ebuilds</li>
-</ul>
-
-<ul>
-  <li>
-    <b>BAD:</b> Who the fuck reads this anyway? (<b>Editor's note</b>:
-    No, seriously, this is a genuine example. Do <e>not</e> do
-    this...)
-  </li>
-  <li><e>GOOD:</e> Version bump to 0.5.1.</li>
-</ul>
-
-</body>
-</section>
-</body>
-</chapter>
-</guide>
diff --git a/ebuild-writing/misc-files/metadata/text.xml b/ebuild-writing/misc-files/metadata/text.xml
deleted file mode 100644 (file)
index aca9a49..0000000
+++ /dev/null
@@ -1,124 +0,0 @@
-<?xml version="1.0"?>
-<guide self="ebuild-writing/misc-files/metadata/">
-<chapter>
-<title>Package and Category <c>metadata.xml</c></title>
-
-<body>
-<p>
-The <c>metadata.xml</c> file is used to specify additional data about a
-package or category.
-</p>
-
-<section>
-<title>Package Metadata</title>
-<body>
-<p>
-For packages, <c>metadata.xml</c> can specify a long description and
-maintainer information. If a long description in any language is
-provided, an English long description must be present. A typical
-example might look like:
-</p>
-
-<codesample lang="sgml">
-    &lt;?xml version="1.0" encoding="UTF-8"?&gt;
-    &lt;!DOCTYPE pkgmetadata SYSTEM "http://www.gentoo.org/dtd/metadata.dtd"&gt;
-    &lt;pkgmetadata&gt;
-        &lt;herd&gt;freedesktop&lt;/herd&gt;
-        &lt;maintainer&gt;
-            &lt;email&gt;dang@gentoo.org&lt;/email&gt;
-            &lt;name&gt;Daniel Gryniewicz&lt;/name&gt;
-        &lt;/maintainer&gt;
-        &lt;longdescription lang="en"&gt;
-           HAL provides a view of the various hardware attached to a system.
-           In addition to this, HAL keeps detailed metadata for each piece of
-           hardware and provide hooks such that system- and desktop-level software
-           can react to changes in the hardware configuration in order to maintain
-           system policy.
-        &lt;/longdescription&gt;
-       &lt;use&gt;
-              &lt;flag name="laptop"&gt;Adds support for power management scripts
-                (&lt;pkg&gt;sys-power/pm-utils&lt;/pkg&gt;)&lt;/flag&gt;
-               &lt;flag name="selinux"&gt;Installs SELinux policies and links HAL to the SELinux
-                       libraries.&lt;/flag&gt;
-       &lt;/use&gt;
-    &lt;/pkgmetadata&gt;
-</codesample>
-
-<p>
-All new packages <b>must</b> include a <c>metadata.xml</c> file which
-specifies at <e>least</e> a herd. If no herd is suitable, <c>no-herd</c>
-should be used, and at least one maintainer must be listed <d/> however,
-if at all possible, find a herd willing to be listed.
-</p>
-
-<p>
-If a package has no maintainer, <c>maintainer-needed@gentoo.org</c>
-should be listed as the maintainer.
-</p>
-
-<p>
-To easily create <c>metadata.xml </c>files, you can use
-<c>app-portage/metagen</c>. There is also a skeleton file, see
-<c>/usr/portage/skel.metadata.xml</c>.
-</p>
-
-<p>
-Commits of package metadata files are handled by <c>repoman</c>. You
-should ensure that you have <c>dev-libs/libxml2</c> installed so that
-the XML can be validated.
-</p>
-
-</body>
-</section>
-
-<section>
-<title>Category Metadata</title>
-<body>
-<p>
-For categories, <c>metadata.xml</c> specifies a long description (in
-English and optionally in other languages). The format is specified
-formally in <uri link="http://www.gentoo.org/proj/en/glep/glep-0034.html">
-GLEP 34</uri>, and the character set <b>must</b> be UTF-8 as specified
-by <uri link="http://www.gentoo.org/proj/en/glep/glep-0031.html">GLEP
-31</uri>. A typical example:
-</p>
-
-<codesample lang="sgml">
-    &lt;?xml version="1.0" encoding="UTF-8"?&gt;
-    &lt;!DOCTYPE catmetadata SYSTEM "http://www.gentoo.org/dtd/metadata.dtd"&gt;
-    &lt;catmetadata&gt;
-            &lt;longdescription lang="en"&gt;
-                The app-vim category contains plugins and syntax file
-                packages for the Vim text editor.
-            &lt;/longdescription&gt;
-            &lt;longdescription lang="de"&gt;
-                Die Kategorie app-vim enthält Plugins und Syntax-Pakete
-                für den Vim Texteditor.
-            &lt;/longdescription&gt;
-    &lt;/catmetadata&gt;
-</codesample>
-
-<p>
-When creating a new category, creating a <c>metadata.xml</c> file
-along with a <c>&lt;longdescription&gt;</c> in English is
-<b>mandatory</b>. Translations are handled by any interested developer
-who speaks a language sufficiently well.
-</p>
-
-<p>
-The correct way to commit a <e>category</e> <c>metadata.xml</c> file
-is currently:
-</p>
-
-<pre>
-xmllint --noout --valid metadata.xml
-glep31check metadata.xml
-cvs commit -m "Adding category metadata.xml for my-category" metadata.xml
-</pre>
-
-</body>
-</section>
-
-</body>
-</chapter>
-</guide>
diff --git a/ebuild-writing/misc-files/patches/text.xml b/ebuild-writing/misc-files/patches/text.xml
deleted file mode 100644 (file)
index 949e105..0000000
+++ /dev/null
@@ -1,127 +0,0 @@
-<?xml version="1.0"?>
-<guide self="ebuild-writing/misc-files/patches/">
-<chapter>
-<title>Patches</title>
-
-<body>
-<p>
-There is no fixed rule for patch naming. The following are guidelines
-only.
-</p>
-
-<p>
-Small patches (less than, say, a few KBytes) should be added to
-<c>${FILESDIR}</c>. If you anticipate having several patches, it often
-helps to create version numbered subdirectories <d/> <c>${FILESDIR}/${PV}/</c>
-is conventional. Patches are best named <c>${P}-what-it-does.patch</c> (or
-<c>.diff</c>), where <c>what-it-does</c> is a two or three word
-description of what the patch is for. If the patch is to fix a
-specific bug, it is often useful to add in the bug number <d/> for
-example, <c>vim-7.0-cron-vars-79981.patch</c>. If the patch is pulled from
-upstream's CVS / SVN repository, it can help to include the revision
-number in the patch name as a suffix to the version part <d/>
-<c>fluxbox-0.9.12-3860-menu-backups.patch</c>.
-</p>
-
-<p>
-Larger patches should be mirrored. When mirroring patches, choosing a
-name that will not cause conflicts is important — the <c>${P}</c>
-prefix is highly recommended here. Mirrored patches are often
-compressed with <c>bzip2</c>. Remember to list these patches in
-<c>SRC_URI</c>.
-</p>
-
-<note>
-Patches included in <c>${FILESDIR}</c> should never be compressed.
-</note>
-
-<p>
-If a package requires many patches, even if they are individually
-small, it is often best to create a patch tarball to avoid cluttering
-up the tree too much.
-</p>
-
-<section>
-<title>Patch Descriptions</title>
-<body>
-<p>
-It is possible to include a description with a patch. This is often
-helpful when others come to work with your packages, or, indeed when
-you come back to take a look at your own package a few months
-later. Good things to include in comments are:
-</p>
-
-<ul>
-  <li>
-    What the patch actually does. Bug numbers are good here.
-  </li>
-  <li>
-    Where the patch came from. Is it an upstream CVS/SVN pull,
-    something from Bugzilla, something you wrote?
-  </li>
-  <li>
-    Whether the patch has been sent upstream, if applicable.
-  </li>
-</ul>
-
-<p>
-To include the description, simply insert it at the top of the patch
-file. The <c>patch</c> tool will ignore leading text until it finds
-something that looks like it might be a 'start patching' instruction,
-so as long as each description line starts with letters (rather than
-numbers, symbols or whitespace) there shouldn't be a
-problem. Alternatively, prefix each description line with a hash
-(that's <c>#</c>, or 'pound' to the USians) sign. It's also best to
-leave a single blank line after the description and before the main
-patch.
-</p>
-
-<p>
-Here's a simple example (<c>023_all_vim-6.3-apache-83565.patch</c>)
-from the <c>vim</c> patch tarball:
-</p>
-
-<pre>
-# Detect Gentoo apache files properly. Gentoo bug 83565.
-
---- runtime/filetype.vim.orig   2005-03-25 01:44:12.000000000 +0000
-+++ runtime/filetype.vim        2005-03-25 01:45:15.000000000 +0000
-@@ -93,6 +93,9 @@
- " Gentoo apache config file locations (Gentoo bug #76713)
- au BufNewFile,BufRead /etc/apache2/conf/*/* setf apache
-
-+" More Gentoo apache config file locations (Gentoo bug #83565)
-+au BufNewFile,BufRead /etc/apache2/{modules,vhosts}.d/*.conf setf apache
-+
- " XA65 MOS6510 cross assembler
- au BufNewFile,BufRead *.a65                    setf a65
-</pre>
-
-</body>
-</section>
-
-<section>
-<title>Adding Patches to the tree</title>
-<body>
-
-<p>
-When adding a patch to the tree be sure to check that the patch doesn't have
-CVS keywords in it that will be expanded (such as <c>$Id$</c>).  If the patch
-contains these, it will break manifests unless you add it to the tree
-correctly.  In the case that it does have the keywords, you should add it by
-doing:
-</p>
-
-<pre>
-cvs add -ko files/${P}-the-cool-patch.path
-</pre>
-
-<p>
-<c>-ko</c> disables keyword expansion for that specific file.  If it doesn't
-have keywords in it, then you can add it normally without the extra argument.
-</p>
-</body>
-</section>
-</body>
-</chapter>
-</guide>
diff --git a/ebuild-writing/misc-files/text.xml b/ebuild-writing/misc-files/text.xml
deleted file mode 100644 (file)
index 31f1421..0000000
+++ /dev/null
@@ -1,23 +0,0 @@
-<?xml version="1.0"?>
-<guide self="ebuild-writing/misc-files/">
-<chapter>
-<title>Miscellaneous Files</title>
-
-<body>
-<p>
-This section contains some notes on various miscellaneous files.
-</p>
-</body>
-
-<section>
-<title>Contents</title>
-<body>
-<contentsTree/>
-</body>
-</section>
-</chapter>
-
-<include href="metadata/"/>
-<include href="changelog/"/>
-<include href="patches/"/>
-</guide>
diff --git a/ebuild-writing/text.xml b/ebuild-writing/text.xml
deleted file mode 100644 (file)
index 2f55b47..0000000
+++ /dev/null
@@ -1,33 +0,0 @@
-<?xml version="1.0"?>
-<guide self="ebuild-writing/">
-<chapter>
-<title>Ebuild Writing</title>
-
-<body>
-<p>
-This section describes how to write an ebuild. It covers the basic format
-of an ebuild and the variables and functions available, and finishes off
-with some general notes and extended examples.
-</p>
-</body>
-
-<section>
-<title>Contents</title>
-<body>
-<contentsTree/>
-</body>
-</section>
-</chapter>
-
-<include href="file-format/"/>
-<include href="eapi/"/>
-<include href="use-conditional-code/"/>
-<include href="error-handling/"/>
-<include href="users-and-groups/"/>
-<include href="messages/"/>
-<include href="variables/"/>
-<include href="using-eclasses/"/>
-<include href="functions/"/>
-<include href="misc-files/"/>
-<include href="common-mistakes/"/>
-</guide>
diff --git a/ebuild-writing/use-conditional-code/text.xml b/ebuild-writing/use-conditional-code/text.xml
deleted file mode 100644 (file)
index 0ffa368..0000000
+++ /dev/null
@@ -1,62 +0,0 @@
-<?xml version="1.0"?>
-<guide self="ebuild-writing/use-conditional-code/">
-<chapter>
-<title>USE Flag Conditional Code</title>
-
-<body>
-<p>
-Often a particular block of code must only be executed if a given USE flag is
-set (or unset). For large blocks, <c>if use foo</c> is best, or for inverse tests
-either <c>if ! use foo</c> or <c>if use !foo</c> can be used (the former is more
-common and is recommended for readability). For single-statement conditions, the
-<c>use foo &amp;&amp; blah</c> (or <c>use foo || blah</c> for negatives) form is often more
-readable.
-</p>
-
-<p>
-The <c>if [ "`use foo`" ]</c> and <c>if [ -n "`use foo`" ]</c> forms which are
-occasionally seen in older code must <b>not</b> be used.
-</p>
-
-<note>
-<c>die</c> will not work as expected within a subshell, so code in the
-form <c>use foo &amp;&amp; ( blah ; blah )</c> should be avoided in favour of a proper if
-statement. See <uri link="::ebuild-writing/error-handling/#die and Subshells"/>.
-</note>
-
-<codesample lang="ebuild">
-    # USE conditional blocks...
-    if use livecd ; then
-        # remove some extra files for a small livecd install
-        rm -fr "${vimfiles}"/{compiler,doc,ftplugin,indent}
-    fi
-
-    # Inverse USE conditional blocks...
-    if ! use cscope ; then
-        # the --disable-cscope configure arg doesn't quite work properly,
-        # so sed it out of feature.h if we're not USEing cscope.
-        sed -i -e '/# define FEAT_CSCOPE/d' src/feature.h || die "couldn't disable cscope"
-    fi
-
-    # USE conditional statements...
-    use ssl &amp;&amp; epatch "${FILESDIR}/${P}-ssl.patch"
-    use sparc &amp;&amp; filter-flags -fomit-frame-pointer
-
-    # Inverse USE conditional statements...
-    use ncurses || epatch "${FILESDIR}/${P}-no-ncurses.patch"
-</codesample>
-
-<p>
-For echoing content based upon a USE flag, there is often a better helper
-function available.
-</p>
-
-<p>
-You must not rely upon <c>use</c> producing an output <d/> this no longer happens.
-If you really need output displayed, use the <c>usev</c> function. The
-<c>useq</c> function is available for explicitly requesting no output.
-</p>
-</body>
-
-</chapter>
-</guide>
diff --git a/ebuild-writing/users-and-groups/text.xml b/ebuild-writing/users-and-groups/text.xml
deleted file mode 100644 (file)
index c48e820..0000000
+++ /dev/null
@@ -1,92 +0,0 @@
-<?xml version="1.0"?>
-<guide self="ebuild-writing/users-and-groups/">
-<chapter>
-<title>Users and Groups</title>
-
-<body>
-<p>
-If your ebuild requires a user or group to be added for a daemon, for example,
-this should be performed via the functions available in <c>eutils.eclass</c>.
-Regardless of whether you are adding a group or a user, this should be performed
-in the <c>pkg_setup</c> function: <c>pkg_setup</c> is sandbox-safe,
-is called before the compile process so a build that requires the user to exist will
-have it, and is also called for both binary and source packages. You may also 
-use the <c>pkg_preinst</c> or <c>pkg_setup</c> functions for user creation, if
-the user is not required during <c>src_compile</c>.
-</p>
-</body>
-
-<section>
-<title>Adding Groups</title>
-<body>
-
-<p>
-To add a group, use the <c>enewgroup</c> function:
-</p>
-
-<pre>
-enewgroup &lt;name&gt; [gid]
-</pre>
-
-<p>
-By default the next available group ID is selected. To set a specfic group ID,
-pass it an extra argument to <c>enewgroup</c>.
-</p>
-
-<note>
-Group IDs should rarely be hardcoded. If this is the case, you should
-probably check first on gentoo-dev.
-</note>
-
-</body>
-</section>
-
-<section>
-<title>Adding Users</title>
-<body>
-
-<p>
-To add a user, use the <c>enewuser</c> function:
-</p>
-
-<pre>
-enewuser &lt;user&gt; [uid] [shell] [homedir] [groups] [params]
-</pre>
-
-<p>
-By default, both <c>enewuser</c> and <c>enewgroup</c> allocate the next available user
-ID or group ID to the new user or group - if not, you explicitly have to specify
-one.
-</p>
-
-<p>
-Arguments for <c>enewuser</c> must be passed in the order as shown above: if you do
-not want to specify a fixed user ID however but do want to set a specific shell,
-for example, use <c>-1</c> for the <c>uid</c> parameter. The same applies for any other
-parameter where you want to keep the default setting.
-</p>
-
-<p>
-Groups for the <c>groups</c> argument should be separated by a comma (<c>,</c>) and
-wrapped correctly, for example:
-</p>
-
-<pre>
-enewuser frozd -1 -1 -1 "backup,frozd"
-</pre>
-
-<p>
-Finally, any data left over for the <c>params</c> argument is passed directly to
-useradd.
-</p>
-
-<note>
-User IDs should rarely be hardcoded. If this is the case, you should
-probably check first on gentoo-dev.
-</note>
-
-</body>
-</section>
-
-</chapter>
-</guide>
diff --git a/ebuild-writing/using-eclasses/text.xml b/ebuild-writing/using-eclasses/text.xml
deleted file mode 100644 (file)
index ff4ce50..0000000
+++ /dev/null
@@ -1,92 +0,0 @@
-<?xml version="1.0"?>
-<guide self="ebuild-writing/using-eclasses/">
-<chapter>
-<title>Using Eclasses</title>
-
-<body>
-<p>
-An eclass is a collection (library) of functions or functionality that is shared
-between packages. See <uri link="::eclass-writing/" /> for the full story on what
-eclasses can do, how they work and how to write them, and <uri link="::eclass-reference/"/>
-for documentation on various commonly used eclasses. This section only explains
-how to use an eclass which has already been written.
-</p>
-</body>
-
-<section>
-<title>The <c>inherit</c> Function</title>
-<body>
-
-<p>
-To use an eclass, it must be 'inherited'. This is done via the <c>inherit</c>
-function, which is provided by <c>ebuild.sh</c>. The <c>inherit</c> statement must
-come at the top of the ebuild, <e>before</e> any functions. Conditional inherits are
-illegal (except where the inheritance criteria are cache-constant <d/> see <uri
-link="::general-concepts/portage-cache"/>).
-</p>
-
-<p>
-After inheriting an eclass, its provided functions can be used as normal. Here'san example ebuild, <c>foomatic-0.1-r2.ebuild</c>, which uses four eclasses:
-</p>
-
-<codesample lang="ebuild">
-# Copyright 1999-2010 Gentoo Foundation
-# Distributed under the terms of the GNU General Public License v2
-# $Header: $
-
-EAPI="2"
-
-inherit eutils bash-completion flag-o-matic autotools
-
-DESCRIPTION="Tool for foo"
-HOMEPAGE="http://foomatic.sf.net"
-SRC_URI="mirror://sourceforge/${PN}/${P}.tar.gz"
-
-LICENSE="GPL-2"
-SLOT="0"
-KEYWORDS="alpha ~amd64 ~x86 ~x86-fbsd"
-IUSE=""
-
-RDEPEND=">=sys-libs/ncurses-5.2
-    >=sys-libs/readline-4.1"
-DEPEND="${RDEPEND}"
-
-src_prepare() {
-       epatch "${FILESDIR}/${P}-gentoo.patch"
-       eautoreconf
-}
-
-src_configure() {
-       econf --sysconfdir=/etc/devtodo
-}
-
-src_compile() {
-       replace-flags -O? -O1
-       emake || die "emake failed"
-}
-
-src_install() {
-       emake DESTDIR="${D}" install || die "emake install failed"
-       dodoc AUTHORS ChangeLog README TODO || die "dodoc failed"
-       dobashcompletion "${FILESDIR}/${PN}.bash-completion" ${PN}
-}
-
-</codesample>
-
-<p>
-Note the <c>inherit</c> immediately after the header.
-</p>
-
-<p>
-The <c>eutils</c> eclass (see <uri link="::eclass-reference/eutils.eclass/"/>) is needed to get the
-<c>epatch</c> function.  The <c>flag-o-matic</c> eclass (see <uri
-link="::eclass-reference/flag-o-matic.eclass/"/>) is needed for <c>replace-flags</c>, and
-the <c>bash-completion</c> eclass (<uri link="::eclass-reference/bash-completion.eclass/"/>) is used
-to handle the bash completion file via <c>dobashcompletion</c> and <c>bash-completion_pkg_postinst</c>.
-</p>
-
-</body>
-</section>
-
-</chapter>
-</guide>
diff --git a/ebuild-writing/variables/text.xml b/ebuild-writing/variables/text.xml
deleted file mode 100644 (file)
index 9b1e130..0000000
+++ /dev/null
@@ -1,446 +0,0 @@
-<?xml version="1.0"?>
-<guide self="ebuild-writing/variables/">
-<chapter>
-<title>Variables</title>
-
-<body>
-<p>
-There are a number of special variables which must be set in ebuilds, and many
-more which can optionally be specified. There are also some predefined variables
-which are of use throughout the ebuild.
-</p>
-</body>
-
-<section>
-<title>Predefined Read-Only Variables</title>
-<body>
-
-<p>
-The following variables are defined for you. You must not attempt to set
-them.
-</p>
-
-<table>
-  <tr>
-    <th>Variable</th>
-    <th>Purpose</th>
-  </tr>
-  <tr>
-    <ti><c>P</c></ti>
-    <ti>Package name and version (excluding revision, if any), for example <c>vim-6.3</c>.</ti>
-  </tr>
-  <tr>
-    <ti><c>PN</c></ti>
-    <ti>Package name, for example <c>vim</c>.</ti>
-  </tr>
-  <tr>
-    <ti><c>PV</c></ti>
-    <ti>Package version (excluding revision, if any), for example <c>6.3</c>.</ti>
-  </tr>
-  <tr>
-    <ti><c>PR</c></ti>
-    <ti>Package revision, or <c>r0</c> if no revision exists.</ti>
-  </tr>
-  <tr>
-    <ti><c>PVR</c></ti>
-    <ti>Package version and revision (if any), for example <c>6.3</c>, <c>6.3-r1</c>.</ti>
-  </tr>
-  <tr>
-    <ti><c>PF</c></ti>
-    <ti>Full package name, <c>${PN}-${PVR}</c>, for example <c>vim-6.3-r1</c>.</ti>
-  </tr>
-  <tr>
-    <ti><c>A</c></ti>
-    <ti>
-      All the source files for the package (excluding those
-      which are not available because of <c>USE</c> flags).
-    </ti>
-  </tr>
-  <tr>
-    <ti><c>CATEGORY</c></ti>
-    <ti>Package's category, for example <c>app-editors</c>.</ti>
-  </tr>
-  <tr>
-    <ti><c>FILESDIR</c></ti>
-    <ti>
-      Path to the ebuild's <c>files/</c> directory, commonly used
-      for small patches and files. Value:
-      <c>"${PORTDIR}/${CATEGORY}/${PN}/files"</c>.
-    </ti>
-  </tr>
-  <tr>
-    <ti><c>WORKDIR</c></ti>
-    <ti>
-      Path to the ebuild's root build directory. Value:
-      <c>"${PORTAGE_BUILDDIR}/work"</c>.
-    </ti>
-  </tr>
-  <tr>
-    <ti><c>T</c></ti>
-    <ti>
-       Path to a temporary directory which may be used by the
-       ebuild. Value: <c>"${PORTAGE_BUILDDIR}/temp"</c>.
-    </ti>
-  </tr>
-  <tr>
-    <ti><c>D</c></ti>
-    <ti>
-      Path to the temporary install directory. Value:
-      <c>"${PORTAGE_BUILDDIR}/image"</c>.
-    </ti>
-  </tr>
-  <tr>
-    <ti><c>ROOT</c></ti>
-    <ti>
-      Path to the root directory. When not using <c>${D}</c>,
-      always prepend <c>${ROOT}</c> to the path.
-    </ti>
-  </tr>
-  <tr>
-    <ti><c>DISTDIR</c></ti>
-    <ti>
-      Contains the path to the directory where all the files
-      fetched for the package are stored.
-    </ti>
-  </tr>
-</table>
-
-</body>
-</section>
-
-<section>
-<title>Required Variables</title>
-<body>
-
-<p>
-The following variables must be defined by every ebuild.
-</p>
-
-<table>
-  <tr>
-    <th>Variable</th>
-    <th>Purpose</th>
-  </tr>
-  <tr>
-    <ti><c>DESCRIPTION</c></ti>
-    <ti>
-    A short (less than 80 characters) description of the
-    package's purpose.
-    </ti>
-  </tr>
-  <tr>
-    <ti><c>SRC_URI</c></ti>
-    <ti>
-    A list of source URIs for the package. Can contain
-    <c>USE</c>-conditional parts, see
-    <uri link="::ebuild-writing/variables#SRC_URI"/>.
-    </ti>
-  </tr>
-  <tr>
-    <ti><c>HOMEPAGE</c></ti>
-    <ti>
-    Package's homepage. If you are unable to locate an official one, try
-    to provide a link to <uri link="http://freshmeat.net">freshmeat.net</uri>
-    or a similar package tracking site. Never refer to a variable name in 
-    the string; include only raw text.
-    </ti>
-  </tr>
-  <tr>
-    <ti><c>KEYWORDS</c></ti>
-    <ti>
-    See <uri link="::ebuild-writing/variables#KEYWORDS"/> and
-    <uri link="::keywording/"/>.
-    </ti>
-  </tr>
-  <tr>
-    <ti><c>SLOT</c></ti>
-    <ti>
-    The package's <c>SLOT</c>. See
-    <uri link="::ebuild-writing/variables#SLOT"/>.
-    </ti>
-  </tr>
-  <tr>
-    <ti><c>LICENSE</c></ti>
-    <ti>
-    The package's license, corresponding exactly (including
-    case) to a file in <c>licenses/</c>. See
-    <uri link="::ebuild-writing/variables#LICENSE"/>.
-    </ti>
-  </tr>
-  <tr>
-    <ti><c>IUSE</c></ti>
-    <ti>
-    A list of all <c>USE</c> flags (excluding arch flags, but
-    including <c>USE_EXPAND</c> flags) used within the ebuild. See
-    <uri link="::ebuild-writing/variables#IUSE"/>.
-    </ti>
-  </tr>
-</table>
-
-</body>
-</section>
-
-<section>
-<title>Optional Variables</title>
-<body>
-
-<p>
-Specifying the following variables is optional:
-</p>
-
-<table>
-  <tr>
-    <th>Variable</th>
-    <th>Purpose</th>
-  </tr>
-  <tr>
-    <ti><c>S</c></ti>
-    <ti>
-    Path to the temporary build directory, used by
-    <c>src_compile</c> and <c>src_install</c>. Default:
-    <c>"${WORKDIR}/${P}"</c>. Ebuilds should <b>not</b> provide a
-    value for this variable if it is the same as the default value.
-    </ti>
-  </tr>
-  <tr>
-    <ti><c>DEPEND</c></ti>
-    <ti>
-    A list of the package's build dependencies.  See
-    <uri link="::general-concepts/dependencies"/>.
-    </ti>
-  </tr>
-  <tr>
-    <ti><c>RDEPEND</c></ti>
-    <ti>
-    A list of the package's runtime dependencies. See
-    <uri link="::general-concepts/dependencies"/>.
-    </ti>
-  </tr>
-  <tr>
-    <ti><c>PDEPEND</c></ti>
-    <ti>
-    A list of packages to be installed after the package
-    is merged. Should only be used where <c>RDEPEND</c> is not
-    possible. See <uri link="::general-concepts/dependencies"/>.
-    </ti>
-  </tr>
-  <tr>
-    <ti><c>RESTRICT</c></ti>
-    <ti>
-    A space-delimited list of portage features to restrict.
-    Valid values are <c>fetch</c>, <c>mirror</c>, <c>strip</c>, <c>test</c> and
-    <c>userpriv</c>. See <c>man 5 ebuild</c> for details.
-    </ti>
-  </tr>
-  <tr>
-    <ti><c>PROVIDE</c></ti>
-    <ti>
-    Any virtuals provided by this package, for example
-    <c>"virtual/editor virtual/emacs"</c>.
-    </ti>
-  </tr>
-</table>
-
-</body>
-</section>
-
-<section>
-<title>SLOT</title>
-<body>
-
-<p>
-When slots are not needed, use <c>SLOT="0"</c>. Do <b>not</b> use <c>SLOT=""</c>, as
-this will disable slotting for this package.
-</p>
-
-<p>
-See <uri link="::general-concepts/slotting/" /> for more information on this variable.
-</p>
-
-</body>
-</section>
-
-<section>
-<title>KEYWORDS</title>
-<body>
-
-<p>
-The only valid construct involving a <c>*</c> inside <c>KEYWORDS</c> is a <c>-*</c>. Do
-<b>not</b> use <c>KEYWORDS="*"</c> or <c>KEYWORDS="~*"</c>.
-</p>
-
-<p>
-See <uri link="::keywording/"/> for how to handle this variable.
-</p>
-
-</body>
-</section>
-
-<section>
-<title>SRC_URI</title>
-
-<subsection>
-<title>Conditional Sources</title>
-<body>
-
-<p>
-Conditional source files based upon USE flags are allowed using the usual
-<c>flag? ( )</c> syntax. This is often useful for arch-specific code or for binary
-packages <d/> downloading sparc binaries on ppc would be a waste of bandwidth.
-</p>
-
-<codesample lang="ebuild">
-SRC_URI="http://example.com/files/${P}-core.tar.bz2
-    x86?   ( http://example.com/files/${P}/${P}-sse-asm.tar.bz2 )
-    ppc?   ( http://example.com/files/${P}/${P}-vmx-asm.tar.bz2 )
-    sparc? ( http://example.com/files/${P}/${P}-vis-asm.tar.bz2 )
-    doc?   ( http://example.com/files/${P}/${P}-docs.tar.bz2 )"
-</codesample>
-
-<p>
-If a <c>USE_EXPAND</c> variable is used to control whether certain optional
-components are installed, the correct thing to do if the variable is unset is
-generally to install <e>all</e> available components.
-</p>
-
-<codesample lang="ebuild">
-SRC_URI="http://example.com/files/${P}-core.tar.bz2
-        examplecards_foo?  ( http://example.com/files/${P}-foo.tar.bz2 )
-        examplecards_bar?  ( http://example.com/files/${P}-bar.tar.bz2 )
-        examplecards_baz?  ( http://example.com/files/${P}-baz.tar.bz2 )
-        !examplecards_foo? ( !examplecards_bar? ( !examplecards_baz? (
-            http://example.com/files/${P}-foo.tar.bz2
-            http://example.com/files/${P}-bar.tar.bz2
-            http://example.com/files/${P}-baz.tar.bz2 ) ) )"
-</codesample>
-
-</body>
-</subsection>
-</section>
-
-<section>
-<title>IUSE</title>
-<body>
-
-<p>
-Note that the <c>IUSE</c> variable is cumulative, so there is no need to specify
-USE flags used only within inherited eclasses within the ebuild's IUSE. Also
-note that it's really really broken in portage versions before 2.0.51.
-</p>
-
-<p>
-Arch USE flags (<c>sparc</c>, <c>mips</c>, <c>x86-fbsd</c> and so on) should not be
-listed.
-</p>
-
-</body>
-</section>
-
-<section>
-<title>LICENSE</title>
-<body>
-
-<p>
-It is possible to specify multiple <c>LICENSE</c> entries, and entries which only
-apply if a particular <c>USE</c> flag is set. The format is the same as for
-<c>DEPEND</c>. See <uri link="http://www.gentoo.org/proj/en/glep/glep-0023.html">
-GLEP 23</uri> for details.
-</p>
-
-</body>
-</section>
-
-<section>
-<title>Version and Name Formatting Issues</title>
-<body>
-
-<p>
-Often upstream's tarball versioning or naming format doesn't quite follow Gentoo
-conventions. Using capital letters in names or differences in how underscores and hyphens
-are used in versions are particularly common. For example, what Gentoo calls <c>foo-1.2.3b</c> may be
-expecting a tarball named <c>Foo-1.2-3b.tar.bz2</c>. Rather than hard coding the package string,
-it is preferable to make <c>MY_PN</c>, <c>MY_PV</c> and <c>MY_P</c> variables and use those to define the
-upstream naming. The easy way of redefining the version, which should be used unless you are sure
-you know what you are doing, is to use the <c>versionator</c> eclass:
-</p>
-
-<codesample lang="ebuild">
-inherit versionator
-MY_PN="Foo"
-MY_PV=$(replace_version_separator 2 '-')
-MY_P="${MY_PN}-${MY_PV}"
-</codesample>
-
-<p>
-This code has the advantage that it will carry on working even if upstream
-switches to a format like <c>Foo-1.3-4.5.tar.bz2</c> (yes, this really happens).
-</p>
-
-<p>
-It is also possible to use bash substitution to achieve the same effect (this is
-how versionator works internally), but this is complicated, error prone and hard
-to read.
-</p>
-
-<p>
-Some ebuilds use calls to <c>sed</c>, <c>awk</c> and / or <c>cut</c> to do this. This
-must <e>not</e> be done for any new code, and should be fixed to use either
-versionator or bash substitution where possible. Global scope non-bash code is
-highly discouraged.
-</p>
-
-<p>
-The <c>versionator</c> eclass can also be used to extract particular components
-from a version string. See <c>man versionator.eclass</c> and the eclass source code
-for further documentation and examples. A brief summary of the functions
-follows.
-</p>
-
-<table>
-  <tr>
-    <th>Function</th>
-    <th>Purpose</th>
-  </tr>
-  <tr>
-    <ti><c>get_all_version_components</c></ti>
-    <ti>Split up a version string into its component parts.</ti>
-  </tr>
-  <tr>
-    <ti><c>get_version_components</c></ti>
-    <ti>Get important version components, excluding '.', '-' and '_'.</ti>
-  </tr>
-  <tr>
-    <ti><c>get_major_version</c></ti>
-    <ti>Get the major version.</ti>
-  </tr>
-  <tr>
-    <ti><c>get_version_component_range</c></ti>
-    <ti>Extract a range of subparts from a version string.</ti>
-  </tr>
-  <tr>
-    <ti><c>get_after_major_version</c></ti>
-    <ti>Get everything after the major version.</ti>
-  </tr>
-  <tr>
-    <ti><c>replace_version_separator</c></ti>
-    <ti>Replace a particular version separator.</ti>
-  </tr>
-  <tr>
-    <ti><c>replace_all_version_separators</c></ti>
-    <ti>Replace all version separators.</ti>
-  </tr>
-  <tr>
-    <ti><c>delete_version_separator</c></ti>
-    <ti>Delete a version separator.</ti>
-  </tr>
-  <tr>
-    <ti><c>delete_all_version_separators</c></ti>
-    <ti>Delete all version separators.</ti>
-  </tr>
-</table>
-
-</body>
-</section>
-
-</chapter>
-</guide>
diff --git a/eclass-reference/bash-completion.eclass/text.xml b/eclass-reference/bash-completion.eclass/text.xml
deleted file mode 100644 (file)
index cc183e2..0000000
+++ /dev/null
@@ -1,47 +0,0 @@
-<?xml version="1.0"?>
-<guide self="eclass-reference/bash-completion.eclass/">
-<chapter>
-<title><c>bash-completion.eclass</c> Reference</title>
-<body>
-
-<p>
-The <c>bash-completion</c> eclass provides functions for installing contributed
-bash-completion scripts. See <uri link="::tasks-reference/completion"/> for how
-to write completion scripts.
-</p>
-
-<table>
-  <tr>
-    <th>
-      Function
-    </th>
-    <th>
-      Details
-    </th>
-  </tr>
-  <tr>
-    <ti>
-      <c>dobashcompletion</c>
-    </ti>
-    <ti>
-      Install a bash completion file if and only if the user has
-      <c>USE="bash-completion"</c>. If <c>BASH_COMPLETION_NAME</c> is set,
-      this will be used for deciding the application name. Otherwise, the second
-      argument will be used (if present), or failing that, <c>${PN}</c>.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>bash-completion_pkg_postinst</c>
-    </ti>
-    <ti>
-      If the user has <c>USE="bash-completion"</c>,
-      displays a message explaining how to activate
-      the completion for this package.
-    </ti>
-  </tr>
-</table>
-
-</body>
-</chapter>
-</guide>
diff --git a/eclass-reference/cvs.eclass/text.xml b/eclass-reference/cvs.eclass/text.xml
deleted file mode 100644 (file)
index 4e0c6b5..0000000
+++ /dev/null
@@ -1,11 +0,0 @@
-<?xml version="1.0"?>
-<guide self="eclass-reference/cvs.eclass/">
-<chapter>
-<title><c>cvs.eclass</c> Reference</title>
-<body>
-
-<todo>Needs to be written</todo>
-
-</body>
-</chapter>
-</guide>
diff --git a/eclass-reference/eutils.eclass/text.xml b/eclass-reference/eutils.eclass/text.xml
deleted file mode 100644 (file)
index f8bbd07..0000000
+++ /dev/null
@@ -1,204 +0,0 @@
-<?xml version="1.0"?>
-<guide self="eclass-reference/eutils.eclass/">
-<chapter>
-<title><c>eutils.eclass</c> Reference</title>
-<body>
-
-<p>
-The <c>eutils</c> eclass provides various useful functions. For full documentation,
-see <c>man eutils.eclass</c>.
-</p>
-
-<table>
-  <tr>
-    <th>
-      Function
-    </th>
-    <th>
-      Details
-    </th>
-  </tr>
-  <tr>
-    <ti>
-      <c>epause</c>
-    </ti>
-    <ti>
-      See <uri link="::function-reference/message-functions"/> and
-      <uri link="::ebuild-writing/messages"/>
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>ebeep</c>
-    </ti>
-    <ti>
-      See <uri link="::function-reference/message-functions"/> and
-      <uri link="::ebuild-writing/messages"/>
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>gen_usr_ldscript</c>
-    </ti>
-    <ti>
-      Generate a linker script in <c>/usr/lib</c> for dynamic
-      libraries in <c>/lib</c>
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>draw_line</c>
-    </ti>
-    <ti>
-      Draw a line the same length as the arguments. Do not
-      use this for messages.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>epatch</c>
-    </ti>
-    <ti>
-      Apply a patch (see <c>man eutils.eclass</c> and
-      <uri link="::ebuild-writing/functions/src_unpack/epatch"/>).
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>have_NPTL</c>
-    </ti>
-    <ti>
-      True if we are using NPTL (threads).
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>get_number_of_jobs</c>
-    </ti>
-    <ti>
-      Try to get the number of jobs to use when compiling.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>emktemp</c>
-    </ti>
-    <ti>
-      Replacement for <c>mktemp</c>.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>egetent</c>
-    </ti>
-    <ti>
-      Wrapper for <c>getent</c>.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>enewuser</c>
-    </ti>
-    <ti>
-      See <uri link="::ebuild-writing/users-and-groups"/>.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>enewgroup</c>
-    </ti>
-    <ti>
-      See <uri link="::ebuild-writing/users-and-groups"/>.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>edos2unix</c>
-    </ti>
-    <ti>
-      Fix one or more files to use Unix line endings.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>make_desktop_entry</c>
-    </ti>
-    <ti>
-      Create a <c>.desktop</c> file. Args are the binary,
-      the name, the icon, the application type and the startup
-      path.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>make_session_desktop</c>
-    </ti>
-    <ti>
-      Create a GDM session file. Arguments are the title and
-      the command.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>domenu</c>
-    </ti>
-    <ti>
-      Install a menu file.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>doicon</c>
-    </ti>
-    <ti>
-      Install an icon file.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>check_license</c>
-    </ti>
-    <ti>
-      Display a license for the user to accept. Argument is
-      the license to use.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>cdrom_get_cds</c>
-    </ti>
-    <ti>
-      See <c>man eutils.eclass</c>.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>cdrom_load_next_cd</c>
-    </ti>
-    <ti>
-      See <c>man eutils.eclass</c>.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>strip-linguas</c>
-    </ti>
-    <ti>
-      Make sure <c>LINGUAS</c> contains only allowed values.
-      See <uri link="::general-concepts/linguas"/>.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>built_with_use</c>
-    </ti>
-    <ti>
-      Check that a package was built with a given USE flag
-      enabled.
-    </ti>
-  </tr>
-</table>
-
-</body>
-</chapter>
-</guide>
diff --git a/eclass-reference/fdo-mime.eclass/text.xml b/eclass-reference/fdo-mime.eclass/text.xml
deleted file mode 100644 (file)
index a0c7717..0000000
+++ /dev/null
@@ -1,41 +0,0 @@
-<?xml version="1.0"?>
-<guide self="eclass-reference/fdo-mime.eclass/">
-<chapter>
-<title><c>fdo-mime.eclass</c> Reference</title>
-<body>
-
-<p>
-The <c>fdo-mime</c> eclass provides functions for working with the FreeDesktop MIME
-database.
-</p>
-
-<table>
-  <tr>
-    <th>
-      Function
-    </th>
-    <th>
-      Details
-    </th>
-  </tr>
-  <tr>
-    <ti>
-      <c>fdo-mime_desktop_database_update</c>
-    </ti>
-    <ti>
-      Updates the desktop database. Should be called after modifying desktop entries.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>fdo-mime_mime_database_update</c>
-    </ti>
-    <ti>
-      Updates the MIME database. Should be called after modifying MIME entries.
-    </ti>
-  </tr>
-</table>
-
-</body>
-</chapter>
-</guide>
diff --git a/eclass-reference/flag-o-matic.eclass/text.xml b/eclass-reference/flag-o-matic.eclass/text.xml
deleted file mode 100644 (file)
index a9646ab..0000000
+++ /dev/null
@@ -1,119 +0,0 @@
-<?xml version="1.0"?>
-<guide self="eclass-reference/flag-o-matic.eclass/">
-<chapter>
-<title><c>flag-o-matic.eclass</c> Reference</title>
-<body>
-
-<p>
-The <c>flag-o-matic</c> eclass provides functions for manipulating <c>CFLAGS</c>,
-<c>CXXFLAGS</c>, <c>LDFLAGS</c> and similar. See
-<uri link="::ebuild-writing/functions/src_compile/build-environment"/> for
-examples.
-</p>
-
-<table>
-  <tr>
-    <th>
-      Function
-    </th>
-    <th>
-      Details
-    </th>
-  </tr>
-  <tr>
-    <ti>
-      <c>filter-flags</c> <e>&lt;flags&gt;</e>
-    </ti>
-    <ti>
-      Removes any occurances of <e>flags</e> in <c>CFLAGS</c>, <c>CXXFLAGS</c>
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>append-flags</c> <e>&lt;flags&gt;</e>
-    </ti>
-    <ti>
-      Appends <e>flags</e> to <c>CFLAGS</c> and <c>CXXFLAGS</c>
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>replace-flags</c> <e>&lt;orig.flag&gt;</e> <e>&lt;new.flag&gt;</e>
-    </ti>
-    <ti>
-      Replaces <e>orig.flag</e> (if present) with <e>new.flag</e> in <c>CFLAGS</c>
-      and <c>CXXFLAGS</c>
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>replace-cpu-flags</c> <e>&lt;old.cpus&gt;</e> <e>&lt;new.cpu&gt;</e>
-    </ti>
-    <ti>
-      Replaces <c>-mtune=</c>, <c>-mcpu=</c> and <c>-march=</c> flags with any of
-      <e>old.cpus</e> with <e>new.cpu</e> in <c>CFLAGS</c> and <c>CXXFLAGS</c>
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>is-flag</c> <e>&lt;flag&gt;</e>
-    </ti>
-    <ti>
-      Tests whether <e>flag</e> is a valid flag with the current compiler
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>strip-flags</c>
-    </ti>
-    <ti>
-      Removes all non-safe flags from <c>CFLAGS</c> and <c>CXXFLAGS</c>
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>strip-unsupported-flags</c>
-    </ti>
-    <ti>
-      Removes any flags in <c>CFLAGS</c> and <c>CXXFLAGS</c> which are not supported
-      by the active compiler
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>get-flag</c> <e>&lt;flag&gt;</e>
-    </ti>
-    <ti>
-      Finds and echoes the value of the specified flag
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>filter-mfpmath</c> <e>&lt;math types&gt;</e>
-    </ti>
-    <ti>
-      Removes the specified maths types from the fpmath specification (if
-      present) in <c>CFLAGS</c> and <c>CXXFLAGS</c>
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>append-ldflags</c>
-    </ti>
-    <ti>
-      Appends the specified flags to <c>LDFLAGS</c>
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>filter-ldflags</c> <e>&lt;flags&gt;</e>
-    </ti>
-    <ti>
-      Remove the specified flags (if present) from <c>LDFLAGS</c>
-    </ti>
-  </tr>
-</table>
-
-</body>
-</chapter>
-</guide>
diff --git a/eclass-reference/gnome2.eclass/text.xml b/eclass-reference/gnome2.eclass/text.xml
deleted file mode 100644 (file)
index 27539b8..0000000
+++ /dev/null
@@ -1,191 +0,0 @@
-<?xml version="1.0"?>
-<guide self="eclass-reference/gnome2.eclass/">
-<chapter>
-<title><c>gnome2.eclass</c> Reference</title>
-<body>
-
-<p>
-The <c>gnome2.eclass</c> provides functions for working with Gnome applications.
-</p>
-
-<subsection>
-<title><c>gnome2.eclass</c> Variables</title>
-<body>
-
-<table>
-  <tr>
-    <th>
-      Variable
-    </th>
-    <th>
-      Details
-    </th>
-  </tr>
-  <tr>
-    <ti>
-      <c>G2CONF</c>
-    </ti>
-    <ti>
-      You can set this variable to add configure options that are passed to <c>econf</c>.
-      Always put this variable inside <c>pkg_setup</c>.  Putting it outside <c>pkg_setup</c>
-      is a QA violation.
-      <p>
-      For example:
-<codesample lang="ebuild">
-pkg_setup() {
-    G2CONF="--disable-scrollkeeper \
-        $(use_enable eds)"
-}
-</codesample>
-      </p>
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>ELTCONF</c>
-    </ti>
-    <ti>
-      You can specify extra options to be passed to <c>elibtoolize</c>.  <c>elibtoolize</c> is run for every
-      package unless you override <c>src_unpack</c> / <c>src_compile</c>.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>USE_EINSTALL</c>
-    </ti>
-    <ti>
-      You can specify to use <c>einstall</c> instead of the default, <c>emake DESTDIR=${D} install</c>.
-      This usually means the package is broken and needs to be fixed.  The fixes need to be sent upstream.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>SCROLLKEEPER_UPDATE</c>
-    </ti>
-    <ti>
-      You can specify to not run scrollkeeper updates for a package.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>DOCS</c>
-    </ti>
-    <ti>
-      You can specify a space seperated list of docs that will be install with the package.
-      ( <c>AUTHORS</c> <c>NEWS</c> )
-    </ti>
-  </tr>
-</table>
-
-</body>
-</subsection>
-
-<subsection>
-<title><c>gnome2.eclass</c> Functions</title>
-<body>
-
-<table>
-  <tr>
-    <th>
-      Function
-    </th>
-    <th>
-      Details
-    </th>
-  </tr>
-  <tr>
-    <ti>
-      <c>gnome2_omf_fix</c>
-    </ti>
-    <ti>
-      This method prevents <c>scrollkeeper-update</c> from running.  Almost all GNOME
-      packages try to run <c>scrollkeeper-update</c> when trying to install/compile.
-      When <c>scrollkeeper-update</c> runs, it creates the directory below, which
-      writes outside the sandbox (see <uri link="::general-concepts/sandbox"/>).
-      In addition, if it were to continue, it would overwrite your
-      <c>scrollkeeper_docs</c> file with only the docs in the current build.
-      <p>
-      The method fixes all <c>Makefile.in</c>'s, <c>Makefile.am</c>'s,
-      <c>${S}/omf-install/Makefile.in</c>, and <c>${S}/omf.make</c>. If any of the files
-      are not one of the default, you can pass addition files as arguments.
-      </p>
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>gnome2_icon_cache_update</c>
-    </ti>
-    <ti>
-      This method updates the gtk icon cache.  GTK does less work if the icons are cached.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>src_unpack</c>
-    </ti>
-    <ti>
-      <c>gnome2_omf_fix</c> is called here so we don't have to put it in every ebuild.
-      ( <e>So</e> many packages need it ) You must remember if you override src_unpack,
-      you need to call gnome2_src_unpack, add gnome2_omf_fix in after the patches, or
-      test to make sure gnome2_omf_fix not needed for that package.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>src_configure</c>
-    </ti>
-    <ti>
-      Runs <c>elibtoolize</c> on the package, sets <c>GST_REGISTRY</c> variable to work
-      around some access violations caused by gstreamer packages.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>src_install</c>
-    </ti>
-    <ti>
-      Delays gconf schemas from being installed until postinst
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>gconf_install</c>
-    </ti>
-    <ti>
-      Installs GConf schema files using gconftool.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>scrollkeeper_update</c>
-    </ti>
-    <ti>
-      Runs scrollkeeper update if <c>SCROLLKEEPER_UPDATE</c> is not 0.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>pkg_postinst</c>
-    </ti>
-    <ti>
-      Calls <c>gconf_install</c>, <c>scrollkeeper_update</c>, <c>fdo-mime_desktop_database_update</c>,
-      <c>fdo-mime_mime_database_update</c>, <c>gnome2_icon_cache_update</c>.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>pkg_postrm</c>
-    </ti>
-    <ti>
-      Calls <c>scrollkeeper_update</c>, <c>fdo-mime_desktop_database_update</c>,
-      <c>fdo-mime_mime_database_update</c>, <c>gnome2_icon_cache_update</c>.
-    </ti>
-  </tr>
-</table>
-
-</body>
-</subsection>
-
-</body>
-</chapter>
-</guide>
diff --git a/eclass-reference/rpm.eclass/text.xml b/eclass-reference/rpm.eclass/text.xml
deleted file mode 100644 (file)
index 5dd7e1e..0000000
+++ /dev/null
@@ -1,78 +0,0 @@
-<?xml version="1.0"?>
-<guide self="eclass-reference/rpm.eclass/">
-<chapter>
-<title><c>rpm.eclass</c> Reference</title>
-<body>
-
-<p>
-The <c>rpm</c> eclass provides RPM unpacking services for packages that must
-extract a source tarball from an RPM.
-</p>
-
-<subsection>
-<title><c>rpm.eclass</c> Variables</title>
-<body>
-
-<table>
-  <tr>
-    <th>
-      Variables
-    </th>
-    <th>
-      Details
-    </th>
-  </tr>
-  <tr>
-    <ti>
-      <c>USE_RPMOFFSET_ONLY</c>
-    </ti>
-    <ti>
-      <c>rpm_unpack</c> normally will use rpm2cpio over rpmoffset if both exist.
-      If this variable is set to 1, <c>rpm_unpack</c> will use rpmoffset.
-    </ti>
-  </tr>
-</table>
-
-</body>
-</subsection>
-
-<subsection>
-<title><c>rpm.eclass</c> Functions</title>
-<body>
-
-<table>
-  <tr>
-    <th>
-      Functions
-    </th>
-    <th>
-      Details
-    </th>
-  </tr>
-  <tr>
-    <ti>
-      <c>rpm_unpack</c> <e>&lt;file&gt;</e>
-    </ti>
-    <ti>
-      Unpacks an RPM.  Behaves in the same fashion as <c>unpack</c>
-      (see <uri link="::ebuild-writing/functions/src_unpack"/>).
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>rpm_src_unpack</c>
-    </ti>
-    <ti>
-      Default <c>src_unpack</c> that loops through <c>${A}</c>
-      calling <c>rpm_unpack</c> for RPM's and <c>unpack</c> for
-      everything else.
-    </ti>
-  </tr>
-</table>
-
-</body>
-</subsection>
-
-</body>
-</chapter>
-</guide>
diff --git a/eclass-reference/subversion.eclass/text.xml b/eclass-reference/subversion.eclass/text.xml
deleted file mode 100644 (file)
index 73ec842..0000000
+++ /dev/null
@@ -1,152 +0,0 @@
-<?xml version="1.0"?>
-<guide self="eclass-reference/subversion.eclass/">
-<chapter>
-<title><c>subversion.eclass</c> Reference</title>
-<body>
-
-<p>
-The <c>subversion</c> eclass provides functions that enable the ebuild author to
-create 'live' ebuilds that fetch the program's sources from a subversion
-repository.
-</p>
-
-<p>
-See <uri link="::ebuild-writing/functions/src_unpack/svn-sources"/> for an introduction.
-</p>
-
-<subsection>
-<title><c>subversion.eclass</c> Variables</title>
-<body>
-
-<table>
-  <tr>
-    <th>
-      Variables
-    </th>
-    <th>
-      Details
-    </th>
-  </tr>
-  <tr>
-    <ti>
-      <c>ESVN_REPO_URI</c>
-    </ti>
-    <ti>
-      URI from which the sources will be fetched.  Valid
-      protocols: http, https, and svn.  At a minimum, this
-      variable <e>must</e> be set.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>ESVN_STORE_DIR</c>
-    </ti>
-    <ti>
-      Location fetched sources will be kept.  Defaults to <c>${DISTDIR}/svn-src</c>.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>ESVN_FETCH_CMD</c>
-    </ti>
-    <ti>
-      Command used for initial checkout.  Defaults to <c>svn checkout</c>.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>ESVN_UPDATE_CMD</c>
-    </ti>
-    <ti>
-      Command used for updating sources.  Defaults to <c>svn update</c>.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>ESVN_PROJECT</c>
-    </ti>
-    <ti>
-      Name of the project.  Defaults to <c>${PN/-svn}</c>.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>ESVN_BOOTSTRAP</c>
-    </ti>
-    <ti>
-      Name of bootstrap script.  This variable is empty by
-      default.  './' is automatically prepended.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>ESVN_PATCHES</c>
-    </ti>
-    <ti>
-      List of patches to apply prior to fetching the sources.
-      In addition to literal filenames, you may also use globbing
-      such as *.diff.  This variable is empty by default.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>ESVN_OPTIONS</c>
-    </ti>
-    <ti>
-      Pass options to the update or checkout command.  This is useful for
-      specifying a particular revision to grab (e.g <c>-r 1337</c>).
-    </ti>
-  </tr>
-</table>
-</body>
-</subsection>
-
-<subsection>
-<title><c>subversion.eclass</c> Functions</title>
-<body>
-
-<table>
-  <tr>
-    <th>
-      Functions
-    </th>
-    <th>
-      Details
-    </th>
-  </tr>
-  <tr>
-    <ti>
-      <c>subversion_src_unpack</c>
-    </ti>
-    <ti>
-      The default <c>src_unpack</c> that runs <c>subversion_svn_fetch</c> and
-      <c>subversion_bootstrap</c>.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>subversion_svn_fetch</c>
-    </ti>
-    <ti>
-      Fetches the program's sources from the URI specified by <c>ESVN_REPO_URI</c>
-      and copies to <c>${S}</c>.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>subversion_bootstrap</c>
-    </ti>
-    <ti>
-      Applies any patches specified by <c>ESVN_PATCHES</c> and executes the bootstrap
-      script specified by <c>ESVN_BOOTSTRAP</c>.
-    </ti>
-  </tr>
-</table>
-
-</body>
-</subsection>
-
-</body>
-</chapter>
-</guide>
-
diff --git a/eclass-reference/text.xml b/eclass-reference/text.xml
deleted file mode 100644 (file)
index fa1bbf6..0000000
+++ /dev/null
@@ -1,31 +0,0 @@
-<?xml version="1.0"?>
-<guide self="eclass-reference/">
-<chapter>
-<title>Eclass Reference</title>
-
-<body>
-<p>
-This section provides a reference for some of the more commonly used eclasses.
-Note that most eclasses have an accompanying manual page. These man pages can be
-installed by emerging <c>app-portage/eclass-manpages</c>.
-</p>
-</body>
-
-<section>
-<title>Contents</title>
-<body>
-<contentsTree/>
-</body>
-</section>
-</chapter>
-
-<include href="bash-completion.eclass/"/>
-<include href="cvs.eclass/"/>
-<include href="eutils.eclass/"/>
-<include href="fdo-mime.eclass/"/>
-<include href="flag-o-matic.eclass/"/>
-<include href="gnome2.eclass/"/>
-<include href="rpm.eclass/"/>
-<include href="subversion.eclass/"/>
-
-</guide>
diff --git a/eclass-writing/text.xml b/eclass-writing/text.xml
deleted file mode 100644 (file)
index 36927ac..0000000
+++ /dev/null
@@ -1,301 +0,0 @@
-<?xml version="1.0"?>
-<guide self="eclass-writing/">
-<chapter>
-<title>Eclass Writing Guide</title>
-
-<body>
-<p>
-This section provides a brief introduction to eclass authoring.
-</p>
-
-<important>
-You should reread the <uri link="::general-concepts/overlay#Overlay and Eclasses"/>
-and <uri link="::general-concepts/portage-cache"/> sections before continuing.
-</important>
-
-<section>
-<title>Purpose of Eclasses</title>
-<body>
-
-<p>
-An eclass is a collection of code which can be used by more than one ebuild. At
-the time of writing, all eclasses live in the <c>eclass/</c> directory in the tree.
-Roughly speaking, there are three kinds of eclass:
-</p>
-
-<ul>
-  <li>
-    Those which provide common functions which are used by many ebuilds (for
-    example, <c>eutils</c>, <c>versionator</c>, <c>cvs</c>, <c>bash-completion</c>)
-  </li>
-  <li>
-    Those which provide a basic build system for many similar packages (for
-    example, <c>vim-plugin</c>, <c>kde</c>)
-  </li>
-  <li>
-    Those which handle one or a small number of packages with complex build
-    systems (for example, <c>vim</c>, <c>toolchain</c>, <c>kernel-2</c>)
-  </li>
-</ul>
-
-</body>
-</section>
-
-<section>
-<title>Adding and Updating Eclasses</title>
-<body>
-
-<p>
-Before committing a new eclass to the tree, it should be emailed to the
-gentoo-dev mailing list with a justification and a proposed implementation. Do
-not skip this step <d/> sometimes a better implementation or an alternative which
-does not require a new eclass will be suggested.
-</p>
-
-<p>
-Before updating <c>eutils</c> or a similar widely used eclass, it is best to email
-the gentoo-dev list. It may be that your proposed change is broken in a way you
-had not anticipated, or that there is an existing function which performs the
-same purpose, or that your function may be better off in its own eclass. If you
-don't email gentoo-dev first, and end up breaking something, expect to be in a
-lot of trouble.
-</p>
-
-<p>
-If there is an existing maintainer for an eclass (this is usually the case), you
-<b>must</b> talk to the maintainer before committing any changes.
-</p>
-
-<p>
-It is not usually necessary to email the gentoo-dev list before making changes
-to a non-general eclass which you maintain. Use common sense here.
-</p>
-
-<warning>
-Committing a broken eclass can kill huge numbers of packages. Since
-<c>repoman</c> is not eclass-aware, be very sure you do proper testing.
-</warning>
-
-<p>
-A simple way to verify syntax is <c>bash -n foo.eclass</c>.
-</p>
-
-</body>
-</section>
-
-<section>
-<title>Removing Eclasses</title>
-<body>
-
-<p>No longer used eclasses may be removed from the tree, but developers must
-adhere to the following process(developers must follow these rules because
-packages installed with a portage version of less than 2.1.4 would break
-during uninstallation or upgrades):</p>
-
-<ol>
-  <li>
-    Make sure that no packages or other eclasses in the tree <c>inherit</c> the
-    eclass.
-  </li>
-  <li>
-    Send a message to the gentoo-dev and gentoo-dev-announce mailing lists
-    announcing that the eclass you are deprecating is now deprecated.
-  </li>
-  <li>
-    Add a warning to all installation phases that the eclass is now deprecated,
-    perhaps with a hint at what, if any, eclass replaced the functionality that
-    the old eclass provided.
-  </li>
-  <li>
-    Remove all functionality related to installation of packages from the eclass.
-  </li>
-  <li>
-    Add a one line comment saying exactly <c># @DEAD</c> so that the
-    eclass-manpages package will not attempt to document it.
-  </li>
-  <li>
-    After two years have passed since the eclass was deprecated, the eclass may
-    be removed from the portage tree.
-  </li>
-</ol>
-
-
-</body>
-</section>
-
-<section>
-<title>Basic Eclass Format</title>
-<body>
-
-<p>
-An eclass is a <c>bash</c> script which is sourced within the ebuild environment.
-Files should be a simple text file with a <c>.eclass</c> extension. Allowed
-characters in the filename are lowercase letters, the digits 0-9, hyphens,
-underscores and dots. Eclasses are not intrinsically versioned.
-</p>
-
-<p>
-Eclasses should start with the standard ebuild header, along with comments
-explaining the maintainer and purpose of the eclass, and any other relevant
-documentation.
-</p>
-
-</body>
-</section>
-
-<section>
-<title>Eclass Variables</title>
-<body>
-
-<p>
-Top level variables may be defined as for ebuilds. If any USE flags are
-used, <c>IUSE</c> must be set. The <c>KEYWORDS</c> variable must <b>not</b> be set in an
-eclass.
-</p>
-
-</body>
-</section>
-
-<section>
-<title>Eclass Functions</title>
-<body>
-
-<p>
-Eclasses may define functions. These functions will be visible to anything which
-inherits the eclass.
-</p>
-
-</body>
-</section>
-
-<section>
-<title>Simple Common Functions Eclass Example</title>
-<body>
-
-<p>
-As an example, the following eclass was written to illustrate a better way of
-installing OSX application files during a discussion on this subject. It defines
-a single function, <c>domacosapp</c>.
-</p>
-
-<codesample lang="ebuild">
-# Copyright 1999-2005 Gentoo Foundation
-# Distributed under the terms of the GNU General Public License v2
-# $Header: $
-
-#
-# Original Author: Ciaran McCreesh &lt;ciaranm@gentoo.org&gt;
-# Purpose: install macos .app files to the relevant location.
-#
-# Bugs to osx@gentoo.org
-#
-
-# domacosapp: install a macos .app file. Usage is 'domacosapp file' or
-# 'domacosapp file newfile'.
-
-domacosapp() {
-    [[ -z "${1}" ]] &amp;&amp; die "usage: domacosapp &lt;file&gt; &lt;new file&gt;"
-    if useq ppc-macos ; then
-        insinto /Applications
-        newins "$1" "${2:-${1}}" || die "Failed to install ${1}"
-    fi
-}
-</codesample>
-
-</body>
-</section>
-
-<section>
-<title>Export Functions</title>
-<body>
-
-<p>
-An eclass may provide default implementations for any of the standard ebuild
-functions (<c>src_unpack</c>, <c>pkg_postinst</c> etc). This can be done either as a
-simple function definition (which is not multiple eclass friendly) or using
-<c>EXPORT_FUNCTIONS</c>. Functions given to <c>EXPORT_FUNCTIONS</c> are implemented
-as normal, but have their name prefixed with <c>${ECLASS}_</c>.
-</p>
-
-<important>
-Only 'standard' functions should be specified in <c>EXPORT_FUNCTIONS</c>.
-</important>
-
-<note><c>EXPORT_FUNCTIONS</c> is a function, <e>not</e> a variable.</note>
-
-<p>
-If multiple eclasses export the same function, the latest (inherited last)
-defined version wins.  If an ebuild defines a function that is exported, this
-gets priority over any eclass version. This can be used to override
-eclass-defined defaults <d/> for example, say we had <c>fnord.eclass</c>:
-</p>
-
-<codesample lang="ebuild">
-EXPORT_FUNCTIONS src_compile
-
-fnord_src_compile() {
-    do_stuff || die
-}
-</codesample>
-
-<p>
-Then an ebuild could do this:
-</p>
-
-<codesample lang="ebuild">
-inherit fnord.eclass
-
-src_compile() {
-    do_pre_stuff || die
-    fnord_src_compile
-    do_post_stuff || die
-}
-</codesample>
-
-</body>
-</section>
-
-<section>
-<title>Simple Build System Eclass Example</title>
-<body>
-
-<p>
-A simple eclass which defines a number of functions and a default
-<c>src_compile</c> for the (hypothetical) <c>jmake</c> build system might look
-something like the following:
-</p>
-
-<codesample lang="ebuild">
-# Copyright 1999-2005 Gentoo Foundation
-# Distributed under the terms of the GNU General Public License v2
-# $Header: $
-
-# Original Author: Ciaran McCreesh &lt;ciaranm@gentoo.org&gt;
-# Purpose: Demonstration of EXPORT_FUNCTIONS. Defines simple wrappers for the
-# (hypothetical) 'jmake' build system and a default src_compile.
-
-EXPORT_FUNCTIONS src_compile
-
-DEPEND="&gt;=sys-devel/jmake-2"
-
-jmake-configure() {
-    jmake configure --prefix=/usr "$@"
-}
-
-jmake-build() {
-    jmake dep &amp;&amp; jmake build "$@"
-}
-
-jmake_src_compile() {
-    jmake-configure || die "configure failed"
-    jmake-build || die "build failed"
-}
-</codesample>
-
-</body>
-</section>
-
-</body>
-
-</chapter>
-</guide>
diff --git a/function-reference/build-functions/text.xml b/function-reference/build-functions/text.xml
deleted file mode 100644 (file)
index dd14233..0000000
+++ /dev/null
@@ -1,58 +0,0 @@
-<?xml version="1.0"?>
-<guide self="function-reference/build-functions/">
-<chapter>
-<title>Build Functions Reference</title>
-
-<body>
-
-<p>
-The following functions, which are all provided by <c>ebuild.sh</c>, are useful
-during the unpack and compile stages.
-</p>
-
-<table>
-  <tr>
-    <th>
-      Function
-    </th>
-    <th>
-      Details
-    </th>
-  </tr>
-  <tr>
-    <ti>
-      <c>unpack archives</c>
-    </ti>
-    <ti>
-      Unpack the specified archives.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>econf args</c>
-    </ti>
-    <ti>
-      Wrapper for <c>./configure</c>. Passes on all <c>args</c>. Will abort (via <c>die</c>) should <c>configure</c> fail.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>emake args</c>
-    </ti>
-    <ti>
-      Wrapper for <c>make</c>. Passes on all <c>args</c>.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>einstall args</c>
-    </ti>
-    <ti>
-      Wrapper for <c>emake install</c>, only to be used if <c>emake DESTDIR="${D}"</c> is unsuitable.
-    </ti>
-  </tr>
-</table>
-
-</body>
-</chapter>
-</guide>
diff --git a/function-reference/install-functions/text.xml b/function-reference/install-functions/text.xml
deleted file mode 100644 (file)
index 9a80753..0000000
+++ /dev/null
@@ -1,352 +0,0 @@
-<?xml version="1.0"?>
-<guide self="function-reference/install-functions/">
-<chapter>
-<title>Install Functions Reference</title>
-<body>
-
-<p>
-The following functions, which are all provided <c>ebuild.sh</c> and the standard
-library, handle various install-related tasks. <c>${D}</c> is automatically handled
-for all of these functions.
-</p>
-
-<p>
-The <c>do*</c> functions, when given multiple arguments, will work upon multiple
-targets. The <c>new*</c> functions take exactly two arguments (except as noted) <d />
-the first is the source name, the second the name to use when installing.
-</p>
-
-<table>
-  <tr>
-    <th>
-      Function
-    </th>
-    <th>
-      Details
-    </th>
-  </tr>
-  <tr>
-    <ti>
-      <c>insinto</c>
-    </ti>
-    <ti>
-      Change install location for <c>doins</c>, <c>newins</c> etc
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>exeinto</c>
-    </ti>
-    <ti>
-      Change install location for <c>doexe</c>, <c>newexe</c> etc
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>docinto</c>
-    </ti>
-    <ti>
-      Change install location for <c>dodoc</c>, <c>newdoc</c> etc
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>insopts</c>
-    </ti>
-    <ti>
-      Specify arguments passed to <c>install</c> (eg <c>-s</c>, <c>-m644</c>).
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>diropts</c>
-    </ti>
-    <ti>
-      Specify arguments passed to <c>install</c> for directories
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>exeopts</c>
-    </ti>
-    <ti>
-      Specify arguments passed to <c>install</c> for executables
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>libopts</c>
-    </ti>
-    <ti>
-      Specify arguments passed to <c>install</c> for libraries
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>dobin</c>
-    </ti>
-    <ti>
-      Install a binary
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>doconfd</c>
-    </ti>
-    <ti>
-      Install an <c>/etc/conf.d</c> file
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>dodir</c>
-    </ti>
-    <ti>
-      Install a directory
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>dodoc</c>
-    </ti>
-    <ti>
-      Install a documentation file
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>doenvd</c>
-    </ti>
-    <ti>
-      Install an <c>/etc/env.d</c> file
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>doexe</c>
-    </ti>
-    <ti>
-      Install an executable
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>dohard</c>
-    </ti>
-    <ti>
-      Create a hardlink to the first argument from the second argument
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>dohtml</c>
-    </ti>
-    <ti>
-      Installs HTML document files into <c>/usr/share/doc/${PF}/html</c>
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>doinfo</c>
-    </ti>
-    <ti>
-      Install a GNU Info document
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>doinitd</c>
-    </ti>
-    <ti>
-      Install an <c>/etc/init.d</c> file
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>doins</c>
-    </ti>
-    <ti>
-      Install a miscellaneous file
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>dojar</c>
-    </ti>
-    <ti>
-      Install a <c>.jar</c> file
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>dolib</c>
-    </ti>
-    <ti>
-      Install a library file
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>dolib.a</c>
-    </ti>
-    <ti>
-      Install a library (<c>.a</c>) file
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>dolib.so</c>
-    </ti>
-    <ti>
-      Install a library (shared object) file
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>doman</c>
-    </ti>
-    <ti>
-      Install a man page
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>domo</c>
-    </ti>
-    <ti>
-      Install a Gettext <c>.mo</c> file
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>dosbin</c>
-    </ti>
-    <ti>
-      Install an <c>sbin/</c> file
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>dosym</c>
-    </ti>
-    <ti>
-      Create a symlink from the second parameter to the first parameter
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>fowners</c>
-    </ti>
-    <ti>
-      Call <c>chown</c> on the specified files in <c>${D}</c>
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>fperms</c>
-    </ti>
-    <ti>
-      Call <c>chmod</c> on the specified files in <c>${D}</c>
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>keepdir</c>
-    </ti>
-    <ti>
-      Create a directory with an empty <c>.keep</c> file in it.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>newbin</c>
-    </ti>
-    <ti>
-      Install a binary using the second argument as the name.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>newconfd</c>
-    </ti>
-    <ti>
-      Install an <c>/etc/conf.d</c> entry using the second argument as the name.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>newdoc</c>
-    </ti>
-    <ti>
-      Install a documentation file using the second argument as the name.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>newenvd</c>
-    </ti>
-    <ti>
-      Install an <c>/etc/env.d</c> file using the second argument as the name.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>newexe</c>
-    </ti>
-    <ti>
-      Install an executable file using the second argument as the name.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>newinitd</c>
-    </ti>
-    <ti>
-      Install an <c>/etc/init.d</c> file using the second argument as the name.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>newins</c>
-    </ti>
-    <ti>
-      Install a miscellaneous file using the second argument as the name.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>newlib.a</c>
-    </ti>
-    <ti>
-      Install a <c>.a</c> library file using the second argument as the name.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>newlib.so</c>
-    </ti>
-    <ti>
-      Install a <c>.so</c> library file using the second argument as the name.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>newman</c>
-    </ti>
-    <ti>
-      Install a manual page using the second argument as the name.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>newsbin</c>
-    </ti>
-    <ti>
-      Install an <c>sbin</c> file using the second argument as the name.
-    </ti>
-  </tr>
-</table>
-
-</body>
-</chapter>
-</guide>
diff --git a/function-reference/message-functions/text.xml b/function-reference/message-functions/text.xml
deleted file mode 100644 (file)
index 24f4b82..0000000
+++ /dev/null
@@ -1,127 +0,0 @@
-<?xml version="1.0"?>
-<guide self="function-reference/message-functions/">
-<chapter>
-<title>Message Functions Reference</title>
-<body>
-
-<p>
-The following functions, which are provided by <c>functions.sh</c>, can be used for
-displaying informational messages.
-</p>
-
-<table>
-  <tr>
-    <th>
-      Function
-    </th>
-    <th>
-      Details
-    </th>
-  </tr>
-  <tr>
-    <ti>
-      <c>einfo</c>
-    </ti>
-    <ti>
-      Display an informational message.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>einfon</c>
-    </ti>
-    <ti>
-      Display an informational message with no trailing newline.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>elog</c>
-    </ti>
-    <ti>
-      Display an informational message, to be logged if logging is enabled.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>ewarn</c>
-    </ti>
-    <ti>
-      Display a warning message.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>eerror</c>
-    </ti>
-    <ti>
-      Display an error message.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>ebegin</c>
-    </ti>
-    <ti>
-      Display the message for the start of an action block.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>eend</c>
-    </ti>
-    <ti>
-      Display the end of an action block.
-    </ti>
-  </tr>
-</table>
-
-<p>
-       The following are available from <c>eutils.eclass</c> . ebeep and epause
-       are deprecated in EAPIS 0, 1 and 2 in favor of GLEP 42 news items and
-       package manager message logging functionality.
-</p>
-
-<table>
-  <tr>
-    <th>
-      Function
-    </th>
-    <th>
-      Details
-    </th>
-  </tr>
-  <tr>
-    <ti>
-      <c>epause</c>
-    </ti>
-    <ti>
-      Pause for the specified number (must be a positive integer) of seconds.
-      Defaults to a sane value.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>ebeep</c>
-    </ti>
-    <ti>
-      Beep the specified number (must be a positive integer) of times. Defaults to a sane value.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>eqawarn</c>
-    </ti>
-    <ti>
-      Used by eclass authors to notify ebuild writers that they are using deprecated functionality.
-    </ti>
-  </tr>
-</table>
-
-<p>
-See <uri link="::ebuild-writing/messages"/> for a detailed discussion.
-</p>
-
-</body>
-</chapter>
-</guide>
diff --git a/function-reference/query-functions/text.xml b/function-reference/query-functions/text.xml
deleted file mode 100644 (file)
index 1193f11..0000000
+++ /dev/null
@@ -1,108 +0,0 @@
-<?xml version="1.0"?>
-<guide self="function-reference/query-functions/">
-<chapter>
-<title>Query Functions Reference</title>
-<body>
-
-<p>
-The following functions, which are provided by <c>ebuild.sh</c>, can be used to
-query variables and similar state.
-</p>
-
-<table>
-  <tr>
-    <th>
-      Function
-    </th>
-    <th>
-      Details
-    </th>
-  </tr>
-  <tr>
-    <ti>
-      <c>use flagname</c>
-    </ti>
-    <ti>
-      Returns a true value if and only if <c>flagname</c> is included in <c>USE</c>
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>useq flagname</c>
-    </ti>
-    <ti>
-      As <c>use</c>, guaranteed to produce no output.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>usev flagname</c>
-    </ti>
-    <ti>
-      As <c>use</c>, echoes <c>flagname</c> upon success.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>use_enable flag str val</c> 
-    </ti>
-    <ti>
-      Echoes either <c>--enable-str=val</c> or <c>--disable-str</c> depending upon <c>useq flag</c>.
-      If <c>str</c> is not specified, uses <c>flag</c> instead. If <c>val</c> is not specified, omits
-      the assignment part.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>use_with flag str val</c>
-    </ti>
-    <ti>
-      As <c>use_enable</c>, but <c>--with-</c> or <c>--without-</c>.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>has flag string</c>
-    </ti>
-    <ti>
-      Returns true if <c>flag</c> is included in the flag list <c>string</c> (example:
-      <c>if has ccache $FEATURES ; then</c>).
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>hasq flag string</c>
-    </ti>
-    <ti>
-      As <c>has</c>, guaranteed quiet.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>hasv flag string</c>
-    </ti>
-    <ti>
-      As <c>has</c>, echoes <c>flag</c> on success.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>best_version pkg</c>
-    </ti>
-    <ti>
-      Echoes the 'best' version of <c>pkg</c> which is currently installed.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>has_version pkg</c>
-    </ti>
-    <ti>
-      True if <c>pkg</c> (can include version specifiers) is installed.
-    </ti>
-  </tr>
-</table>
-
-</body>
-</chapter>
-</guide>
diff --git a/function-reference/sandbox-functions/text.xml b/function-reference/sandbox-functions/text.xml
deleted file mode 100644 (file)
index f80b2c6..0000000
+++ /dev/null
@@ -1,71 +0,0 @@
-<?xml version="1.0"?>
-<guide self="function-reference/sandbox-functions/">
-<chapter>
-<title>Sandbox Functions Reference</title>
-<body>
-
-<p>
-The following functions, which are all provided by <c>ebuild.sh</c>, handle working
-with the sandbox.
-</p>
-
-<table>
-  <tr>
-    <th>
-      Function
-    </th>
-    <th>
-      Details
-    </th>
-  </tr>
-  <tr>
-    <ti>
-      <c>addread</c>
-    </ti>
-    <ti>
-      Add one single additional item to the sandbox allowed read list.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>addwrite</c>
-    </ti>
-    <ti>
-      Add one single additional item to the sandbox allowed write list. <b>Note</b>:
-      If at all possible, use <c>addpredict</c> instead. Using <c>addwrite</c> is <b>not</b> an
-      appropriate alternative to making your package build sandbox-friendly.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>adddeny</c>
-    </ti>
-    <ti>
-      Add one single additional item to the sandbox deny write list.
-    </ti>
-  </tr>
-  <tr>
-    <ti>
-      <c>addpredict</c>
-    </ti>
-    <ti>
-      Add one single additional item to the sandbox predict (pretend to allow write) list.
-    </ti>
-  </tr>
-</table>
-
-<p>
-None of these functions accept multiple arguments in one call. The sandbox is
-recursive, so to allow predicted writes to <c>/foo/bar</c> and <c>/foo/baz</c>,
-<c>addpredict /foo</c> would be sufficient.
-</p>
-
-<p>
-See <uri link="::general-concepts/sandbox"/> for details on how the sandbox works.
-See <uri link="::appendices/common-problems/#Handling Access Violations"/> for how
-to handle sandbox-related build problems.
-</p>
-
-</body>
-</chapter>
-</guide>
diff --git a/function-reference/text.xml b/function-reference/text.xml
deleted file mode 100644 (file)
index 336321d..0000000
+++ /dev/null
@@ -1,26 +0,0 @@
-<?xml version="1.0"?>
-<guide self="function-reference/">
-<chapter>
-<title>Function Reference</title>
-
-<body>
-<p>
-The following functions are available for use in ebuilds:
-</p>
-</body>
-
-<section>
-<title>Contents</title>
-<body>
-<contentsTree/>
-</body>
-</section>
-</chapter>
-
-<include href="build-functions/"/>
-<include href="install-functions/"/>
-<include href="message-functions/"/>
-<include href="query-functions/"/>
-<include href="sandbox-functions/"/>
-
-</guide>
diff --git a/general-concepts/autotools/diagram.svg b/general-concepts/autotools/diagram.svg
deleted file mode 100644 (file)
index 7e205e1..0000000
+++ /dev/null
@@ -1,102 +0,0 @@
-<?xml version="1.0" standalone="no"?>
-<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" 
-    "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
-<svg viewBox="0 50 510 360" width="510" height="360" xmlns="http://www.w3.org/2000/svg" version="1.1">
-    <desc>Autotools Build Process</desc>
-    <rect x="-10" y="-10" width="1000" height="1000" fill="#eeeeee" id="background" />
-
-    <rect x="0" y="70" width="470" height="122"
-        stroke-width="1" stroke="black" fill="none"
-        stroke-dasharray="5,5" rx="10" ry="10" />
-    <text style="text-anchor: middle; font-style: italic;"
-        x="400" y="150">Usually handled</text>
-    <text style="text-anchor: middle; font-style: italic;"
-        x="400" y="164">by upstream</text>
-
-    <rect x="130" y="197" width="330" height="63"
-        stroke-width="1" stroke="black" fill="none"
-        stroke-dasharray="5,5" rx="10" ry="10" />
-    <text style="text-anchor: middle; font-style: italic;"
-        x="410" y="225">Shipped with</text>
-    <text style="text-anchor: middle; font-style: italic;"
-        x="410" y="239">the package</text>
-
-    <rect x="10" y="150" width="80" height="30"
-        fill="#ccccff" stroke="black" stroke-width="2" />
-    <text style="text-anchor: middle;" x="50" y="170">Makefile.am</text>
-
-    <line x1="90"  y1="165" x2="130" y2="165" stroke-width="2" stroke="black" />
-    <line x1="130" y1="165" x2="122" y2="160" stroke-width="2" stroke="black" />
-    <line x1="130" y1="165" x2="122" y2="170" stroke-width="2" stroke="black" />
-
-    <polygon points="130,165 180,145 230,165 180,185" fill="#ffffff"
-        stroke="black" stroke-width="2" />
-    <text style="text-anchor: middle;" x="180" y="169">automake</text>
-
-    <line x1="180" y1="185" x2="180" y2="215" stroke-width="2" stroke="black" />
-    <line x1="185" y1="207" x2="180" y2="215" stroke-width="2" stroke="black" />
-    <line x1="175" y1="207" x2="180" y2="215" stroke-width="2" stroke="black" />
-
-    <rect x="140" y="215" width="80" height="30"
-        fill="#ccffcc" stroke="black" stroke-width="2" />
-    <text style="text-anchor: middle;" x="180" y="235">Makefile.in</text>
-
-    <line x1="220" y1="230" x2="260" y2="230" stroke-width="2" stroke="black" />
-    <line x1="260" y1="230" x2="252" y2="235" stroke-width="2" stroke="black" />
-    <line x1="260" y1="230" x2="252" y2="225" stroke-width="2" stroke="black" />
-
-    <polygon points="260,230 310,210 360,230 310,250" fill="#ccffcc"
-        stroke="black" stroke-width="2" />
-    <text style="text-anchor: middle;" x="310" y="234">configure</text>
-
-    <line x1="310" y1="115"  x2="310" y2="210" stroke-width="2" stroke="black" />
-    <line x1="315" y1="202"  x2="310" y2="210" stroke-width="2" stroke="black" />
-    <line x1="305" y1="202"  x2="310" y2="210" stroke-width="2" stroke="black" />
-
-    <polygon points="260,95 310,75 360,95 310,115" fill="#ffffff"
-        stroke="black" stroke-width="2" />
-    <text style="text-anchor: middle;" x="310" y="99">autoconf</text>
-
-
-    <line x1="220" y1="95" x2="260" y2="95" stroke-width="2" stroke="black" />
-    <line x1="260" y1="95" x2="252" y2="90" stroke-width="2" stroke="black" />
-    <line x1="260" y1="95" x2="252" y2="100" stroke-width="2" stroke="black" />
-
-
-    <rect x="140" y="80" width="80" height="30"
-        fill="#ccccff" stroke="black" stroke-width="2" />
-    <text style="text-anchor: middle;" x="180" y="93" >configure.in /</text>
-    <text style="text-anchor: middle;" x="180" y="105">configure.ac</text>
-
-    <line x1="90"  y1="165" x2="130" y2="165" stroke-width="2" stroke="black" />
-    <line x1="130" y1="165" x2="122" y2="160" stroke-width="2" stroke="black" />
-    <line x1="130" y1="165" x2="122" y2="170" stroke-width="2" stroke="black" />
-
-    <line x1="310" y1="250"  x2="310" y2="285" stroke-width="2" stroke="black" />
-    <line x1="315" y1="278"  x2="310" y2="285" stroke-width="2" stroke="black" />
-    <line x1="305" y1="278"  x2="310" y2="285" stroke-width="2" stroke="black" />
-
-    <rect x="270" y="285" width="80" height="30"
-        fill="#ccffcc" stroke="black" stroke-width="2" />
-    <text style="text-anchor: middle;" x="310" y="305">Makefile</text>
-
-    <line x1="350"  y1="300" x2="390" y2="300" stroke-width="2" stroke="black" />
-    <line x1="390"  y1="300" x2="382" y2="295" stroke-width="2" stroke="black" />
-    <line x1="390"  y1="300" x2="382" y2="305" stroke-width="2" stroke="black" />
-
-    <polygon points="390,300 440,280 490,300 440,320" fill="#ffffff"
-        stroke="black" stroke-width="2" />
-    <text style="text-anchor: middle;" x="440" y="304">make</text>
-
-    <line x1="440" y1="320"  x2="440" y2="355" stroke-width="2" stroke="black" />
-    <line x1="435" y1="348"  x2="440" y2="355" stroke-width="2" stroke="black" />
-    <line x1="445" y1="348"  x2="440" y2="355" stroke-width="2" stroke="black" />
-
-    <ellipse cx="440" cy="375" rx="50" ry="20" stroke-width="2" stroke="black"
-        fill="#ffcccc" />
-    <text style="text-anchor: middle;" x="440" y="378">program</text>
-
-</svg>
-
-<!-- vim: set ft=xml sw=4 sts=4 et : -->
-
diff --git a/general-concepts/autotools/text.xml b/general-concepts/autotools/text.xml
deleted file mode 100644 (file)
index 4961e91..0000000
+++ /dev/null
@@ -1,676 +0,0 @@
-<?xml version="1.0"?>
-<guide self="general-concepts/autotools/">
-<chapter>
-<title>The Basics of Autotools</title>
-
-<body>
-<todo>
-This is too long for <uri link="::general-concepts"/>. It needs to be split up and
-moved somewhere, either to a top-level of its own or into <uri link="::appendices/"/>.
-</todo>
-
-<p>
-An understanding of GNU autotools (<c>automake</c>, <c>autoconf</c> etc.) can be useful
-when working with ebuilds:
-</p>
-
-<ul>
-  <li>
-    Finding and correcting build issues is often easier if the build system is
-    not seen simply as a scary black box.
-  </li>
-  <li>
-    The autotools input files can help when determining a package's build-time
-    dependencies.
-  </li>
-  <li>
-    The risk of accidentally breaking something by patching the wrong file at the
-    wrong time is greatly reduced if the relationship between the build system
-    files is understood.
-  </li>
-</ul>
-</body>
-
-<section>
-<title>Major Autotools Components</title>
-
-<body>
-<p>
-Autotools is a collection of related packages which, when used together, remove
-much of the difficulty involved in creating portable software. These tools,
-together with a few relatively simple upstream-supplied input files, are used to
-create the build system for a package.
-</p>
-
-<figure short="How autotools fits together" link="diagram.png">
-A basic overview of how the main autotools components fit together.
-</figure>
-
-<p>
-In a simple setup:
-</p>
-
-<ul>
-  <li>
-    The <c>autoconf</c> program produces a <c>configure</c> script from either
-    <c>configure.in</c> or <c>configure.ac</c> (see note below).
-  </li>
-  <li>
-    The <c>automake</c> program produces a <c>Makefile.in</c> from a <c>Makefile.am</c>.
-  </li>
-  <li>
-    The <c>configure</c> script is run to produce one or more <c>Makefile</c> files from
-    <c>Makefile.in</c> files.
-  </li>
-  <li>
-    The <c>make</c> program uses the <c>Makefile</c> to compile the program.
-  </li>
-</ul>
-
-
-<note>
-The <c>configure.in</c> name used to be standard. However, the GNU
-documentation now recommends <c>configure.ac</c> as it is more obvious which
-program should be used when processing it. The files perform the same purpose
-and have the same format <d/> the only difference is the name.
-</note>
-
-<p>
-You will see autotools being used variously in both <c>src_unpack</c> and
-<c>src_compile</c>. The QA people prefer it in <c>src_unpack</c> <d/> the rationale is
-that <c>src_unpack</c> handles "getting the package ready to be compiled" <d/> but
-there is no official policy which mandates this.
-</p>
-
-<p>
-The <c>autoreconf</c> tool supposedly runs <c>autoconf</c> (and <c>automake</c>,
-<c>autoheader</c>, <c>aclocal</c>, <c>autopoint</c> and <c>libtoolize</c>) as necessary.
-Sometimes it works. Some packages ship a shell script named <c>autogen.sh</c> which
-does the same thing (this is <e>not</e> related to <c>autogen</c>).
-</p>
-
-<warning>
-You must <b>not</b> attempt to modify any of the generated files in
-between running <c>configure</c> and <c>make</c>. This can lead to autotools
-trying to be clever and recreate the files, in turn leading to your changes
-being removed. In some situations this will also result in <c>./configure</c>
-arguments being silently dropped, which can give broken dependencies.
-The best way to proceed is usually to work with the <c>.ac</c> / <c>.in</c> files
-instead.
-</warning>
-
-</body>
-</section>
-
-<section>
-<title>Simple Autotools Patching Example</title>
-<body>
-
-<p>
-The following snippet illustrates the correct way to proceed after patching
-either <c>Makefile.am</c> or <c>configure.ac</c>:
-</p>
-
-<codesample lang="ebuild">
-src_unpack() {
-    unpack ${A}
-    cd "${S}"
-
-    # Remove problematic LDFLAGS declaration
-    sed -i -e '/^LDFLAGS/d' src/Makefile.am
-
-    # Rerun autotools
-    einfo "Regenerating autotools files..."
-    WANT_AUTOCONF=2.5 autoconf || die "autoconf failed"
-    WANT_AUTOMAKE=1.9 automake || die "automake failed"
-}
-
-src_compile() {
-    econf $(use_enable nls)
-    emake || die "emake failed"
-}
-</codesample>
-
-<p>
-The <c>einfo</c> message before running autotools is not mandatory. However, these
-steps can sometimes take a while and may produce no output, so it may make sense
-to let the user know that something is still happening. See
-<uri link="::ebuild-writing/messages"/>.
-</p>
-
-</body>
-</section>
-
-<section>
-<title>The <c>configure.ac</c> File</title>
-<body>
-
-<p>
-The <c>configure.ac</c> file is used to create the <c>./configure</c> script. It
-consists of a series of macros which are processed and expanded by <c>autoconf</c>.
-These macros can check for packages and libraries, handle <c>--enable</c> and
-<c>--with</c> switches, and generate various files.
-</p>
-
-</body>
-
-<subsection>
-<title>Basic Format of <c>configure.ac</c></title>
-<body>
-
-<p>
-The <c>configure.ac</c> file is a basic text file. Indenting and whitespace are
-largely irrelevant. Comments are indicated by the string <c>dnl</c> (<c>dnl</c> is
-actually a macro which discards the remainder of the input <d/> it stands for
-"discard new line").
-</p>
-
-<p>
-If the previous sentence made you uneasy, you should probably stop reading this
-page. It gets far worse.
-</p>
-
-<p>
-A typical file might start with something like the following:
-</p>
-
-<codesample lang="m4">
-dnl Process this file with autoconf
-AC_INIT(appname, 0.1)
-AC_PREREQ(2.5)
-AC_CONFIG_SRCDIR(src/main.c)
-AC_CONFIG_AUX_DIR(config)
-AM_INIT_AUTOMAKE(1.8)
-</codesample>
-
-<p>
-The <c>AC_PREREQ</c> line, if present, tells you which <c>autoconf</c> version you
-need. This is useful, because <c>autoconf</c> is not compatible between versions.
-In the above example, we need <c>=autoconf-2.5*</c>. and we should
-<c>export WANT_AUTOCONF="2.5"</c> (or use the <c>autoconf-2.59</c> script) when calling
-<c>autoconf</c>.
-</p>
-
-<p>
-The <c>AM_INIT_AUTOMAKE</c> line tells us which <c>automake</c> version we need.
-Again, there is little chance that an <c>automake-1.7</c> script will work properly
-with <c>automake-1.8</c>. Setting <c>WANT_AUTOMAKE="1.8"</c> in the environment can be
-used to make an unversioned <c>automake</c> call run the correct version.
-</p>
-
-<note>
-The <c>WANT_</c> variables are a Gentoo feature that originally came from
-Mandrake. Other distributions may handle things differently.
-</note>
-
-<p>
-Usually, some standard checks will follow:
-</p>
-
-<codesample lang="m4">
-dnl Check for toolchain and install components
-AC_PROG_CC
-AC_PROG_INSTALL
-AC_PROG_LN_S
-AC_PROG_RANLIB
-</codesample>
-
-<p>
-For non-standard applications, you may also see manual checks:
-</p>
-
-<codesample lang="m4">
-dnl Check for sed
-AC_CHECK_PROGS(regex_cmd, sed)
-if test x$regex_cmd = "x" ; then
-    AC_MSG_ERROR([sed is required to build the data files.])
-fi
-</codesample>
-
-<p>
-You may also see checks for compiler features:
-</p>
-
-<codesample lang="m4">
-dnl Check that our compiler can do const and inline
-AC_C_CONST
-AC_C_INLINE
-</codesample>
-
-<p>
-Library and header checks:
-</p>
-
-<codesample lang="m4">
-dnl Check for standard headers:
-AC_HEADER_STDC
-AC_HEADER_DIRENT
-AC_CHECK_HEADERS([stdlib.h stdio.h libintl.h locale.h])
-
-dnl Check for libraries:
-AC_CHECK_LIB(ssl, SSL_free)
-</codesample>
-
-<p>
-And function checks:
-</p>
-
-<codesample lang="m4">
-dnl Check for functions:
-AC_CHECK_FUNCS([setlocale strtol])
-</codesample>
-
-<p>
-Often these will be all jumbled together without any useful comments. In some
-cases, many of the checks done won't even be necessary for the application in
-question <d/> most autotools code is copy/pasted rather than written from scratch,
-and <c>autoscan</c> (a tool which helps write <c>configure.ac</c>) is sometimes
-over-eager to add in checks.
-</p>
-
-<p>
-The file will finish with some output functions:
-</p>
-
-<codesample lang="m4">
-AM_CONFIG_HEADER(config.h)
-AC_OUTPUT(Makefile src/Makefile nls/Makefile man/Makefile tests/Makefile)
-</codesample>
-
-<p>
-These are used to make the <c>./configure</c> script generate the relevant files.
-</p>
-
-</body>
-</subsection>
-
-<subsection>
-<title>Enable and Disable Checks</title>
-<body>
-
-<