From 1fb3c501ed269cb3d553b28238134c5e529bc83a Mon Sep 17 00:00:00 2001
From: Juan RP <xtraeme@gmail.com>
Date: Fri, 18 Apr 2014 08:53:14 +0200
Subject: [PATCH] xbps-{install,query}.8: clarify package expression matching.

---
 bin/xbps-install/xbps-install.8 | 5 ++++-
 bin/xbps-query/xbps-query.8     | 5 ++++-
 2 files changed, 8 insertions(+), 2 deletions(-)

diff --git a/bin/xbps-install/xbps-install.8 b/bin/xbps-install/xbps-install.8
index 9dfc0ac9..badff79f 100644
--- a/bin/xbps-install/xbps-install.8
+++ b/bin/xbps-install/xbps-install.8
@@ -1,4 +1,4 @@
-.Dd April 7, 2014
+.Dd April 18, 2014
 .Os Void Linux
 .Dt xbps-install 8
 .Sh NAME
@@ -24,9 +24,11 @@ supports 3 ways to specify them:
 .It
 by package name, i.e:
 .Dq Sy foo .
+The package with the greatest version available in all repositories will be choosen
 .It
 by exact package name and version, i.e:
 .Dq Sy foo-1.0_1 .
+The first package matching expression in a repository will be choosen.
 .It
 by specifying a package name and version separated by any of the following version comparators:
 .Bl -item -width xx -compact
@@ -46,6 +48,7 @@ greater or equal than
 .Pp
 Example:
 .Dq Sy foo>=2.0 .
+The first package matching expression in a repository will be choosen.
 .Sh OPTIONS
 .Bl -tag -width -x
 .It Fl A, Fl -automatic
diff --git a/bin/xbps-query/xbps-query.8 b/bin/xbps-query/xbps-query.8
index a191ebcf..5843f7dc 100644
--- a/bin/xbps-query/xbps-query.8
+++ b/bin/xbps-query/xbps-query.8
@@ -1,4 +1,4 @@
-.Dd April 7, 2014
+.Dd April 18, 2014
 .Os Void Linux
 .Dt xbps-query 8
 .Sh NAME
@@ -26,9 +26,11 @@ supports 3 ways to specify them:
 .It
 by package name, i.e:
 .Dq Sy foo .
+The package with the greatest version available in all repositories will be choosen.
 .It
 by exact package name and version, i.e:
 .Dq Sy foo-1.0_1 .
+The first package matching expression in a repository will be choosen.
 .It
 by specifying a package name and version separated by any of the following version comparators:
 .Bl -item -width xx -compact
@@ -48,6 +50,7 @@ greater or equal than
 .Pp
 Example:
 .Dq Sy foo>=2.0 .
+The first package matching expression in a repository will be choosen.
 .Sh OPTIONS
 .Bl -tag -width -x
 .It Fl C, Fl -config Ar file