[gentoo-commits] proj/devmanual:master commit in: function-reference/install-functions/, ebuild-writing/functions/src_prepare/, ...

2020-01-22 Thread Ulrich Müller
commit: 9e1a56d2ff7389708c55423037cb96570e4d52ed
Author: Ulrich Müller  gentoo  org>
AuthorDate: Mon Jan 20 16:32:43 2020 +
Commit: Ulrich Müller  gentoo  org>
CommitDate: Thu Jan 23 00:01:01 2020 +
URL:https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=9e1a56d2

ebuild-writing/eapi: Move EAPI=2 information to other sections.

- doman language support: incorporated into
  function-reference/install-functions
- Blockers incorporated into general-concepts/dependencies
  (also say "weak" and "strong" blockers instead of "soft" and "hard",
  in order to agree with the terms used in PMS)
- USE dependencies: already in general-concepts/dependencies
- SRC_URI arrows: incorporated into ebuild-writing/variables
- src_prepare: already in ebuild-writing/functions/src_prepare
- src_configure: already in ebuild-writing/functions/src_configure
- Execution order: already in ebuild-writing/functions
- Default phase functions moved to ebuild-writing/functions

Signed-off-by: Ulrich Müller  gentoo.org>

 ebuild-writing/eapi/text.xml   | 184 -
 ebuild-writing/functions/src_compile/text.xml  |  53 ++
 .../functions/src_prepare/epatch/text.xml  |  23 +--
 ebuild-writing/functions/src_prepare/text.xml  |  16 +-
 ebuild-writing/functions/src_unpack/text.xml   |  17 +-
 ebuild-writing/functions/text.xml  |  37 +
 ebuild-writing/variables/text.xml  |   5 +-
 function-reference/install-functions/text.xml  |  12 +-
 general-concepts/autotools/text.xml|  20 +--
 general-concepts/dependencies/text.xml |  40 +++--
 10 files changed, 113 insertions(+), 294 deletions(-)

diff --git a/ebuild-writing/eapi/text.xml b/ebuild-writing/eapi/text.xml
index f7427fd..048284f 100644
--- a/ebuild-writing/eapi/text.xml
+++ b/ebuild-writing/eapi/text.xml
@@ -62,190 +62,6 @@ is the best.  Using the features of the latest EAPI is 
encouraged.
 
 
 
-
-EAPI=2
-
-
-EAPI 2 Helpers
-
-
-   
-   doman Language Support
-   
-   doman automatically detects language codes and puts it 
in the
-   appropriate directory.
-   
-
-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
-
-   
-
-
-
-
-
-EAPI 2 Metadata
-
-
-   
-   Blockers
-   
-   
-   New Meaning for Old Syntax
-   
-   Blockers which use the previously existing 
! syntax
-   now have a slightly different meaning. These 
so-called
-   weak blocks 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.
-   
-   
-   
-   New !! Operator
-   
-   A new !! operator for strong 
blocks is now
-   supported, for use in special cases for which 
temporary
-   simultaneous installation of conflicting 
packages should not be
-   allowed. If both weak and strong blocks match a 
given package,
-   the strong block takes precedence.
-   
-   
-   
-   
-   
-   USE Dependencies
-   
-   It is possible to depend on USE-flags of packages.
-   
-   Examples:
-   
-   foo[bar] means that package foo must have 
USE-flag bar
-   enabled
-   foo[bar,baz] means that the package foo must 
have both
-   the bar and baz USE-flags enabled
-   
-   foo[-bar,baz] means that the package foo 
must have the
-   bar USE-flag disabled and baz USE-flag 
enabled
-   foo[bar?] means bar? ( foo[bar] ) !b

[gentoo-commits] proj/devmanual:master commit in: function-reference/install-functions/, ebuild-writing/functions/src_prepare/, ...

2018-10-24 Thread Brian Evans
commit: ffa353428d17602c069d4cd2206a698497cc4c33
Author: Brian Evans  gentoo  org>
AuthorDate: Wed Oct 24 14:46:49 2018 +
Commit: Brian Evans  gentoo  org>
CommitDate: Wed Oct 24 14:46:49 2018 +
URL:https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=ffa35342

More XML syntax fixes

Signed-off-by: Brian Evans  gentoo.org>

 ebuild-writing/eapi/text.xml  | 8 
 ebuild-writing/functions/src_prepare/text.xml | 4 ++--
 function-reference/install-functions/text.xml | 2 +-
 3 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/ebuild-writing/eapi/text.xml b/ebuild-writing/eapi/text.xml
index 8653b20..1eb82b9 100644
--- a/ebuild-writing/eapi/text.xml
+++ b/ebuild-writing/eapi/text.xml
@@ -1054,7 +1054,7 @@ src_install() {
Empty groupings are banned
Groupings which are empty, such as DEPEND="|| ( 
${empty_var} )" will now generate an error.
Furthermore, conditions within groupings are more strictly 
enforced.
-   Eg. REQUIRED_USE="|| ( foo? ( bar ) baz? ( zoinks )" 
would previously work with USE="-a -b" now requires
+   Eg. REQUIRED_USE="|| ( foo? ( bar ) baz? ( zoinks )" 
would previously work with USE="-a -b" now requires
either USE="foo bar" or USE="baz zoinks".


@@ -1066,7 +1066,7 @@ src_install() {
 
 

-   package.provided banned
+   package.provided banned
Profiles may no longer contain a package.provided 
file with EAPI=7.

 
@@ -1127,8 +1127,8 @@ src_install() {
New function dostrip

The dostrip helper has been added with 
EAPI=7.
-   This function controls whether or not to strip a 
binary.
-   dostrip -x [file] will exclude a binary from 
being stripped.
+   This function controls whether or not to strip a 
binary.
+   dostrip -x [file] will exclude a binary from 
being stripped.
Conversely, when combined with RESTRICT=strip, 
dostrip [file] selects a binary
file to be stripped.


diff --git a/ebuild-writing/functions/src_prepare/text.xml 
b/ebuild-writing/functions/src_prepare/text.xml
index 214dfbf..0425bb1 100644
--- a/ebuild-writing/functions/src_prepare/text.xml
+++ b/ebuild-writing/functions/src_prepare/text.xml
@@ -46,9 +46,9 @@ Beginning with EAPI=6, the src_prepare function gained a new 
default implementat
 
 src_prepare() {
 if declare -p PATCHES | grep -q "^declare -a "; then
-[[ -n ${PATCHES[@]} ]] && eapply "${PATCHES[@]}"
+[[ -n ${PATCHES[@]} ]] && eapply "${PATCHES[@]}"
 else
-[[ -n ${PATCHES} ]] && eapply ${PATCHES}
+[[ -n ${PATCHES} ]] && eapply ${PATCHES}
 fi
 eapply_user
 }

diff --git a/function-reference/install-functions/text.xml 
b/function-reference/install-functions/text.xml
index e42b4f6..d0c8833 100644
--- a/function-reference/install-functions/text.xml
+++ b/function-reference/install-functions/text.xml
@@ -243,7 +243,7 @@ the first is the source name, the second the name to use 
when installing.
   domo
 
 
-  Install a Gettext .mo file
+  Install a Gettext .mo file
   (EAPI=7) No longer looks at the value of into