[gentoo-commits] proj/devmanual:master commit in: ebuild-writing/eapi/

[Fabian Groffen]

commit:     645a16f5ba91e0cb1ee013a5f252c2eef9baf811
Author:     Fabian Groffen <grobian <AT> gentoo <DOT> org>
AuthorDate: Tue Apr 30 12:58:11 2013 +0000
Commit:     Fabian Groffen <grobian <AT> gentoo <DOT> org>
CommitDate: Tue Apr 30 12:58:11 2013 +0000
URL:        http://git.overlays.gentoo.org/gitweb/?p=proj/devmanual.git;a=commit;h=645a16f5

Encourage usage of latest EAPI, bug #464250

---
 ebuild-writing/eapi/text.xml |   13 +++++++++----
 1 files changed, 9 insertions(+), 4 deletions(-)

diff --git a/ebuild-writing/eapi/text.xml b/ebuild-writing/eapi/text.xml
index be31b36..1ee4026 100644
--- a/ebuild-writing/eapi/text.xml
+++ b/ebuild-writing/eapi/text.xml
@@ -33,8 +33,8 @@ 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:
+If EAPI is undefined in an ebuild, then EAPI=0 is selected.  You should
+set the EAPI variable, by specifying it at the top of the ebuild:
 </p>
 
 <note>
@@ -42,11 +42,11 @@ Most developers prefer to set the EAPI version without quotes. However, the PMS
 </note>
 
 <codesample lang="ebuild">
-# Copyright 1999-2010 Gentoo Foundation
+# Copyright 1999-2013 Gentoo Foundation
 # Distributed under the terms of the GNU General Public License v2
 # $Header: $
 
-EAPI=1
+EAPI=5
 inherit eutils
 
 </codesample>
@@ -56,6 +56,11 @@ EAPI must only be defined in ebuild files, not eclasses. (eclasses may have
 EAPI-conditional code)
 </important>
 
+<p>
+When writing new ebuilds developers can choose whathever EAPI they think
+is the best.  Using the features of the latest EAPI is encouraged.
+</p>
+
 </body>
 </section>