[gentoo-commits] proj/devmanual:master commit in: function-reference/query-functions/, ebuild-writing/user-submitted/, ...

2024-05-07 Thread Ulrich Müller
commit: fd9c0342503dd70838f2ecc75434d76349304079
Author: Ulrich Müller  gentoo  org>
AuthorDate: Mon Apr 29 16:28:46 2024 +
Commit: Ulrich Müller  gentoo  org>
CommitDate: Tue May  7 17:16:53 2024 +
URL:https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=fd9c0342

Fix internal references

Internal links referring to sections were broken by the previous
"Sentence case devmanual" commit.

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

 appendices/common-problems/text.xml |  8 
 appendices/contributors/text.xml|  8 
 appendices/devbook-guide/text.xml   | 14 +++---
 archs/alpha/text.xml|  2 +-
 archs/amd64/text.xml| 17 +
 archs/mips/text.xml |  2 +-
 archs/sparc/text.xml|  4 ++--
 ebuild-maintenance/git/text.xml |  2 +-
 ebuild-writing/eapi/text.xml|  9 +
 ebuild-writing/file-format/text.xml |  4 ++--
 ebuild-writing/functions/pkg_nofetch/text.xml   |  2 +-
 .../functions/src_compile/build-environment/text.xml|  2 +-
 ebuild-writing/functions/src_test/text.xml  |  2 +-
 ebuild-writing/functions/text.xml   |  6 +++---
 ebuild-writing/misc-files/metadata/text.xml |  4 ++--
 ebuild-writing/misc-files/patches/text.xml  |  4 ++--
 ebuild-writing/use-conditional-code/text.xml|  2 +-
 ebuild-writing/user-submitted/text.xml  |  2 +-
 ebuild-writing/variables/text.xml   |  2 +-
 eclass-writing/text.xml |  2 +-
 function-reference/build-functions/text.xml |  2 +-
 function-reference/query-functions/text.xml |  4 ++--
 function-reference/sandbox-functions/text.xml   |  2 +-
 general-concepts/autotools/text.xml |  2 +-
 general-concepts/dependencies/text.xml  |  4 ++--
 general-concepts/ebuild-revisions/text.xml  |  4 ++--
 general-concepts/manifest/text.xml  |  2 +-
 general-concepts/mirrors/text.xml   |  3 ++-
 general-concepts/sandbox/text.xml   |  2 +-
 general-concepts/slotting/text.xml  |  4 ++--
 general-concepts/tree/text.xml  |  2 +-
 keywording/text.xml |  2 +-
 profiles/categories/text.xml|  2 +-
 profiles/use.mask/text.xml  |  2 +-
 quickstart/text.xml |  7 ---
 tools-reference/bash/text.xml   |  2 +-
 tools-reference/text.xml|  2 +-
 37 files changed, 75 insertions(+), 71 deletions(-)

diff --git a/appendices/common-problems/text.xml 
b/appendices/common-problems/text.xml
index 84bb610..6ebc098 100644
--- a/appendices/common-problems/text.xml
+++ b/appendices/common-problems/text.xml
@@ -59,8 +59,8 @@ in use, there are various alternatives:
 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
 bash constructs. The built-in helpers of EAPI 7 are useful here. See
-
-and .
+
+and .
   
   
 has_version, best_version
@@ -101,7 +101,7 @@ for security reasons. If this message is shown, you have a 
couple of options:
   
   
 Use append-ldflags (see
-)
+)
 to add -Wl,-z,now. This will affect all binaries installed, 
not just the setXid ones.
   
 
@@ -131,7 +131,7 @@ inheritance occurring. Most commonly:
   
   
 When working with eclasses in an overlay with a stale cache. See .
+link="::general-concepts/overlay/#Overlay and eclasses"/>.
   
   
 When working with a stale Portage cache.

diff --git a/appendices/contributors/text.xml b/appendices/contributors/text.xml
index 2808df1..da7fe3b 100644
--- a/appendices/contributors/text.xml
+++ b/appendices/contributors/text.xml
@@ -13,7 +13,7 @@ This page lists the contributions to the Gentoo Development 
Guide:
   Main Content
 
 
-  
+  
 
 
   
@@ -23,7 +23,7 @@ This page lists the contributions to the Gentoo Development 
Guide:
 
 
   ,
-  
+  
 
 
   
@@ -33,7 +33,7 @@ This page lists the contributions to the Gentoo Development 
Guide:
 
 
   ,
-  
+  
 
 
   
@@ -123,7 +123,7 @@ Misc
   Search functionality
 
 
-  
+  
 
 
   ,

diff --git a/appendices/devbook-guide/text.xml 
b/appendices/devbook-guide/text.xml
index 243017d..5c4aec7 100644
--- a/appendices/devbook-guide/text.xml
+++ b/appendices/devbook-guide/text.xml
@@ -533,12 +533,12 @@ here syndrome as recommended by the
 
 DevBook XML makes it really easy to reference other parts of the 

[gentoo-commits] proj/devmanual:master commit in: function-reference/query-functions/

2023-10-05 Thread Ulrich Müller
commit: 546b966a7f10773de891ab4e280e3aefe0c142c0
Author: Ulrich Müller  gentoo  org>
AuthorDate: Sun Oct  1 17:29:06 2023 +
Commit: Ulrich Müller  gentoo  org>
CommitDate: Sun Oct  1 17:29:06 2023 +
URL:https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=546b966a

function-reference/query-functions: usev accepts two args in EAPI 8

Closes: https://bugs.gentoo.org/914590
Signed-off-by: Ulrich Müller  gentoo.org>

 function-reference/query-functions/text.xml | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/function-reference/query-functions/text.xml 
b/function-reference/query-functions/text.xml
index 9d599e8..0233e26 100644
--- a/function-reference/query-functions/text.xml
+++ b/function-reference/query-functions/text.xml
@@ -39,10 +39,11 @@ query variables and similar state.
   
   
 
-  usev flagname
+  usev flagname [true output]
 
 
-  As use, echoes flagname upon success.
+  As use, but also echoes flagname upon success. In EAPI 8
+  and later, echoes the second argument instead, if it is specified.
 
   
   



[gentoo-commits] proj/devmanual:master commit in: function-reference/query-functions/

2021-06-13 Thread Ulrich Müller
commit: 79871f29c8034612df39cc341f6ce33b0f48a41f
Author: John Helmert III  gentoo  org>
AuthorDate: Tue Apr 13 20:42:38 2021 +
Commit: Ulrich Müller  gentoo  org>
CommitDate: Sun Jun 13 11:48:16 2021 +
URL:https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=79871f29

function-reference/query-functions: document missing pms functions

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

 function-reference/query-functions/text.xml | 20 
 1 file changed, 20 insertions(+)

diff --git a/function-reference/query-functions/text.xml 
b/function-reference/query-functions/text.xml
index da24380..b4be963 100644
--- a/function-reference/query-functions/text.xml
+++ b/function-reference/query-functions/text.xml
@@ -45,6 +45,17 @@ query variables and similar state.
   As use, echoes flagname upon success.
 
   
+  
+
+  usex flag [true output] [false output] [true suffix] [false 
suffix]
+
+
+  If flag is enabled, echo [true output][true suffix], otherwise
+  echo [false output][false suffix]. If unspecified, true and false outputs
+  are equal to "yes" and "no" respectively. The suffixes default to empty
+  strings.
+
+  
   
 
   use_enable flag str val 
@@ -63,6 +74,15 @@ query variables and similar state.
   As use_enable, but --with- or --without-.
 
   
+  
+
+  in_iuse flag
+
+
+  Returns true if the ebuild can use flag in use queries,
+  false otherwise.
+
+  
   
 
   has word item...



[gentoo-commits] proj/devmanual:master commit in: function-reference/query-functions/

2020-11-05 Thread Ulrich Müller
commit: 11e783db48d1095bb33ac54b04cbc0d7518a3f37
Author: Ulrich Müller  gentoo  org>
AuthorDate: Mon Oct 26 15:43:28 2020 +
Commit: Ulrich Müller  gentoo  org>
CommitDate: Mon Oct 26 15:43:28 2020 +
URL:https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=11e783db

function-reference/query-functions: Correct description of "has".

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

 function-reference/query-functions/text.xml | 14 ++
 1 file changed, 6 insertions(+), 8 deletions(-)

diff --git a/function-reference/query-functions/text.xml 
b/function-reference/query-functions/text.xml
index 8511c93..da24380 100644
--- a/function-reference/query-functions/text.xml
+++ b/function-reference/query-functions/text.xml
@@ -65,19 +65,17 @@ query variables and similar state.
   
   
 
-  has flag string
+  has word item...
 
 
-  Returns true if flag is included in the flag list string
-  (example: if has ccache $FEATURES ; then).
-  The condition is inverted if prefixed with an exclamation mark,
-  !flag.
+  Returns true if word is found in the list of subsequent
+  item arguments (example: if has ccache $FEATURES ; then).
   It is guaranteed that has produces no output.
 
   
   
 
-  hasq flag string
+  hasq word item...
 
 
   Deprecated synonym for has.
@@ -85,10 +83,10 @@ query variables and similar state.
   
   
 
-  hasv flag string
+  hasv word item...
 
 
-  As has, echoes flag on success.
+  As has, echoes word on success.
 
   
   



[gentoo-commits] proj/devmanual:master commit in: function-reference/query-functions/

2018-10-24 Thread Brian Evans
commit: b52cc8dffe22a0f0428d1bb533acc1b1b92e411e
Author: Brian Evans  gentoo  org>
AuthorDate: Mon Sep 17 14:58:21 2018 +
Commit: Brian Evans  gentoo  org>
CommitDate: Wed Oct 24 12:56:36 2018 +
URL:https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=b52cc8df

function-reference/query-functions: Add EAPI=7 options for {has,best}_version

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

 function-reference/query-functions/text.xml | 12 ++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/function-reference/query-functions/text.xml 
b/function-reference/query-functions/text.xml
index 97d2dfb..8511c93 100644
--- a/function-reference/query-functions/text.xml
+++ b/function-reference/query-functions/text.xml
@@ -93,18 +93,22 @@ query variables and similar state.
   
   
 
-  best_version pkg
+  best_version [option] pkg
 
 
   Echoes category, name and version of the highest version of pkg
   that is currently installed.
   Example: best_version app-editors/emacs:24 will output
   app-editors/emacs-24.5-r3.
+  (EAPI=7) An option may also be specified to query certain types of 
dependencies.
+  -b for BDEPEND
+  -d for DEPEND
+  -r (default) for RDEPEND
 
   
   
 
-  has_version pkg[flag]
+  has_version [option] pkg[flag]
 
 
   True if pkg (can include
@@ -113,6 +117,10 @@ query variables and similar state.
   )
   is installed. Example: has_version
   "=app-editors/nano-2.5.3[nls,spell]".
+  (EAPI=7) An option may also be specified to query certain types of 
dependencies.
+  -b for BDEPEND
+  -d for DEPEND
+  -r (default) for RDEPEND
 
   
 



[gentoo-commits] proj/devmanual:master commit in: function-reference/query-functions/

2016-11-29 Thread Göktürk Yüksek
commit: 9101c681314f17ff94abc075afc1d80c42742383
Author: Wim Muskee  gmail  com>
AuthorDate: Mon Nov 14 19:44:29 2016 +
Commit: Göktürk Yüksek  gentoo  org>
CommitDate: Wed Nov 30 05:56:06 2016 +
URL:https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=9101c681

function-reference/query-functions: add has_version flag explanation, bug 
#307065

 function-reference/query-functions/text.xml | 7 +--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/function-reference/query-functions/text.xml 
b/function-reference/query-functions/text.xml
index f53963d..a9f898d 100644
--- a/function-reference/query-functions/text.xml
+++ b/function-reference/query-functions/text.xml
@@ -102,10 +102,13 @@ query variables and similar state.
   
   
 
-  has_version pkg
+  has_version pkg[flag]
 
 
-  True if pkg (can include version specifiers) is installed.
+  True if pkg (can include version specifiers and
+  )
+  is installed. Example: has_version
+  "=app-editors/nano-2.5.3[nls,spell]".
 
   
 



[gentoo-commits] proj/devmanual:master commit in: function-reference/query-functions/

2016-11-29 Thread Göktürk Yüksek
commit: 9bbf459d0797873313b3c8e269943f3f7caaffdd
Author: Göktürk Yüksek  gentoo  org>
AuthorDate: Wed Nov 30 05:52:50 2016 +
Commit: Göktürk Yüksek  gentoo  org>
CommitDate: Wed Nov 30 05:56:10 2016 +
URL:https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=9bbf459d

function-reference/query-functions: enhance has_version with a cross-ref

Add a link to "version specifiers" in the dependencies section for
has_version.

 function-reference/query-functions/text.xml | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/function-reference/query-functions/text.xml 
b/function-reference/query-functions/text.xml
index a9f898d..66e595f 100644
--- a/function-reference/query-functions/text.xml
+++ b/function-reference/query-functions/text.xml
@@ -105,7 +105,9 @@ query variables and similar state.
   has_version pkg[flag]
 
 
-  True if pkg (can include version specifiers and
+  True if pkg (can include
+  
+  and
   )
   is installed. Example: has_version
   "=app-editors/nano-2.5.3[nls,spell]".



[gentoo-commits] proj/devmanual:master commit in: function-reference/query-functions/

2015-02-15 Thread Markos Chandras
commit: a0d88ff5f5337d40905e7f4a87659b89578cd12b
Author: yac yac AT blesmrt DOT net
AuthorDate: Sun Feb 15 07:12:48 2015 +
Commit: Markos Chandras hwoarang AT gentoo DOT org
CommitDate: Sun Feb 15 07:12:48 2015 +
URL:
http://sources.gentoo.org/gitweb/?p=proj/devmanual.git;a=commit;h=a0d88ff5

Replace weasel word with proper description

---
 function-reference/query-functions/text.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/function-reference/query-functions/text.xml 
b/function-reference/query-functions/text.xml
index dc88b9d..67d4315 100644
--- a/function-reference/query-functions/text.xml
+++ b/function-reference/query-functions/text.xml
@@ -96,7 +96,7 @@ query variables and similar state.
   cbest_version pkg/c
 /ti
 ti
-  Echoes the 'best' version of cpkg/c which is currently installed.
+  Echoes the highest version of cpkg/c which is currently installed.
 /ti
   /tr
   tr



[gentoo-commits] proj/devmanual:master commit in: function-reference/query-functions/

2015-02-15 Thread Markos Chandras
commit: cacfdb329a8e98356a37f5a6e6c99fb4398d6221
Author: yac yac AT blesmrt DOT net
AuthorDate: Sun Feb 15 07:37:36 2015 +
Commit: Markos Chandras hwoarang AT gentoo DOT org
CommitDate: Sun Feb 15 07:37:36 2015 +
URL:
http://sources.gentoo.org/gitweb/?p=proj/devmanual.git;a=commit;h=cacfdb32

Fix factual error

---
 function-reference/query-functions/text.xml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/function-reference/query-functions/text.xml 
b/function-reference/query-functions/text.xml
index 67d4315..f53963d 100644
--- a/function-reference/query-functions/text.xml
+++ b/function-reference/query-functions/text.xml
@@ -96,7 +96,8 @@ query variables and similar state.
   cbest_version pkg/c
 /ti
 ti
-  Echoes the highest version of cpkg/c which is currently installed.
+  Echoes the highest versioned atom of cpkg/c which is currently
+  installed.
 /ti
   /tr
   tr