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

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

[Markos Chandras]

commit:     a0d88ff5f5337d40905e7f4a87659b89578cd12b
Author:     yac <yac <AT> blesmrt <DOT> net>
AuthorDate: Sun Feb 15 07:12:48 2015 +0000
Commit:     Markos Chandras <hwoarang <AT> gentoo <DOT> org>
CommitDate: Sun Feb 15 07:12:48 2015 +0000
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.
       <c>best_version pkg</c>
     </ti>
     <ti>
-      Echoes the 'best' version of <c>pkg</c> which is currently installed.
+      Echoes the highest version of <c>pkg</c> which is currently installed.
     </ti>
   </tr>
   <tr>

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

[Markos Chandras]

commit:     cacfdb329a8e98356a37f5a6e6c99fb4398d6221
Author:     yac <yac <AT> blesmrt <DOT> net>
AuthorDate: Sun Feb 15 07:37:36 2015 +0000
Commit:     Markos Chandras <hwoarang <AT> gentoo <DOT> org>
CommitDate: Sun Feb 15 07:37:36 2015 +0000
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.
       <c>best_version pkg</c>
     </ti>
     <ti>
-      Echoes the highest version of <c>pkg</c> which is currently installed.
+      Echoes the highest versioned atom of <c>pkg</c> which is currently
+      installed.
     </ti>
   </tr>
   <tr>

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

[Göktürk Yüksek]

commit:     9bbf459d0797873313b3c8e269943f3f7caaffdd
Author:     Göktürk Yüksek <gokturk <AT> gentoo <DOT> org>
AuthorDate: Wed Nov 30 05:52:50 2016 +0000
Commit:     Göktürk Yüksek <gokturk <AT> gentoo <DOT> org>
CommitDate: Wed Nov 30 05:56:10 2016 +0000
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.
       <c>has_version pkg[flag]</c>
     </ti>
     <ti>
-      True if <c>pkg</c> (can include version specifiers and
+      True if <c>pkg</c> (can include
+      <uri link="::general-concepts/dependencies#version specifiers"/>
+      and
       <uri link="::general-concepts/dependencies#built with use dependencies"/>)
       is installed. Example: <c>has_version
       "=app-editors/nano-2.5.3[nls,spell]"</c>.

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

[Göktürk Yüksek]

commit:     9101c681314f17ff94abc075afc1d80c42742383
Author:     Wim Muskee <wimmuskee <AT> gmail <DOT> com>
AuthorDate: Mon Nov 14 19:44:29 2016 +0000
Commit:     Göktürk Yüksek <gokturk <AT> gentoo <DOT> org>
CommitDate: Wed Nov 30 05:56:06 2016 +0000
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.
   </tr>
   <tr>
     <ti>
-      <c>has_version pkg</c>
+      <c>has_version pkg[flag]</c>
     </ti>
     <ti>
-      True if <c>pkg</c> (can include version specifiers) is installed.
+      True if <c>pkg</c> (can include version specifiers and
+      <uri link="::general-concepts/dependencies#built with use dependencies"/>)
+      is installed. Example: <c>has_version
+      "=app-editors/nano-2.5.3[nls,spell]"</c>.
     </ti>
   </tr>
 </table>

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

[Brian Evans]

commit:     b52cc8dffe22a0f0428d1bb533acc1b1b92e411e
Author:     Brian Evans <grknight <AT> gentoo <DOT> org>
AuthorDate: Mon Sep 17 14:58:21 2018 +0000
Commit:     Brian Evans <grknight <AT> gentoo <DOT> org>
CommitDate: Wed Oct 24 12:56:36 2018 +0000
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 <grknight <AT> 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.
   </tr>
   <tr>
     <ti>
-      <c>best_version pkg</c>
+      <c>best_version [option] pkg</c>
     </ti>
     <ti>
       Echoes category, name and version of the highest version of <c>pkg</c>
       that is currently installed.
       Example: <c>best_version app-editors/emacs:24</c> will output
       <c>app-editors/emacs-24.5-r3</c>.
+      (EAPI=7) An option may also be specified to query certain types of dependencies.
+      <c>-b</c> for <c>BDEPEND</c>
+      <c>-d</c> for <c>DEPEND</c>
+      <c>-r</c> (default) for <c>RDEPEND</c>
     </ti>
   </tr>
   <tr>
     <ti>
-      <c>has_version pkg[flag]</c>
+      <c>has_version [option] pkg[flag]</c>
     </ti>
     <ti>
       True if <c>pkg</c> (can include
@@ -113,6 +117,10 @@ query variables and similar state.
       <uri link="::general-concepts/dependencies#built with use dependencies"/>)
       is installed. Example: <c>has_version
       "=app-editors/nano-2.5.3[nls,spell]"</c>.
+      (EAPI=7) An option may also be specified to query certain types of dependencies.
+      <c>-b</c> for <c>BDEPEND</c>
+      <c>-d</c> for <c>DEPEND</c>
+      <c>-r</c> (default) for <c>RDEPEND</c>
     </ti>
   </tr>
 </table>

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

[Ulrich Müller]

commit:     11e783db48d1095bb33ac54b04cbc0d7518a3f37
Author:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
AuthorDate: Mon Oct 26 15:43:28 2020 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Mon Oct 26 15:43:28 2020 +0000
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 <ulm <AT> 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.
   </tr>
   <tr>
     <ti>
-      <c>has flag string</c>
+      <c>has word item...</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>).
-      The condition is inverted if prefixed with an exclamation mark,
-      <c>!flag</c>.
+      Returns true if <c>word</c> is found in the list of subsequent
+      <c>item</c> arguments (example: <c>if has ccache $FEATURES ; then</c>).
       It is guaranteed that <c>has</c> produces no output.
     </ti>
   </tr>
   <tr>
     <ti>
-      <c>hasq flag string</c>
+      <c>hasq word item...</c>
     </ti>
     <ti>
       Deprecated synonym for <c>has</c>.
@@ -85,10 +83,10 @@ query variables and similar state.
   </tr>
   <tr>
     <ti>
-      <c>hasv flag string</c>
+      <c>hasv word item...</c>
     </ti>
     <ti>
-      As <c>has</c>, echoes <c>flag</c> on success.
+      As <c>has</c>, echoes <c>word</c> on success.
     </ti>
   </tr>
   <tr>

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

[Ulrich Müller]

commit:     79871f29c8034612df39cc341f6ce33b0f48a41f
Author:     John Helmert III <ajak <AT> gentoo <DOT> org>
AuthorDate: Tue Apr 13 20:42:38 2021 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Sun Jun 13 11:48:16 2021 +0000
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 <ajak <AT> gentoo.org>
Signed-off-by: Ulrich Müller <ulm <AT> 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 <c>use</c>, echoes <c>flagname</c> upon success.
     </ti>
   </tr>
+  <tr>
+    <ti>
+      <c>usex flag [true output] [false output] [true suffix] [false suffix]</c>
+    </ti>
+    <ti>
+      If <c>flag</c> 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.
+    </ti>
+  </tr>
   <tr>
     <ti>
       <c>use_enable flag str val</c> 
@@ -63,6 +74,15 @@ query variables and similar state.
       As <c>use_enable</c>, but <c>--with-</c> or <c>--without-</c>.
     </ti>
   </tr>
+  <tr>
+    <ti>
+      <c>in_iuse flag</c>
+    </ti>
+    <ti>
+      Returns true if the ebuild can use <c>flag</c> in <c>use</c> queries,
+      false otherwise.
+    </ti>
+  </tr>
   <tr>
     <ti>
       <c>has word item...</c>

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

[Ulrich Müller]

commit:     546b966a7f10773de891ab4e280e3aefe0c142c0
Author:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
AuthorDate: Sun Oct  1 17:29:06 2023 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Sun Oct  1 17:29:06 2023 +0000
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 <ulm <AT> 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.
   </tr>
   <tr>
     <ti>
-      <c>usev flagname</c>
+      <c>usev flagname [true output]</c>
     </ti>
     <ti>
-      As <c>use</c>, echoes <c>flagname</c> upon success.
+      As <c>use</c>, but also echoes <c>flagname</c> upon success. In EAPI 8
+      and later, echoes the second argument instead, if it is specified.
     </ti>
   </tr>
   <tr>