commit:     035c62a44e976d328a31703b824a306d248ef197
Author:     Fabian Groffen <grobian <AT> gentoo <DOT> org>
AuthorDate: Wed Jun 19 07:38:32 2019 +0000
Commit:     Fabian Groffen <grobian <AT> gentoo <DOT> org>
CommitDate: Wed Jun 19 07:38:32 2019 +0000
URL:        https://gitweb.gentoo.org/proj/portage-utils.git/commit/?id=035c62a4

libq/atom: document atom_to_string takes any matching prefix string

Basically any matching prefix string will work, so CATEGORY could be
CATE or C or anything inbetween the full name and its first character.
Care should be taken, S for instance, selects SLOT, not SUBSLOT, and it
won't warn either.

Signed-off-by: Fabian Groffen <grobian <AT> gentoo.org>

 libq/atom.c | 1 +
 1 file changed, 1 insertion(+)

diff --git a/libq/atom.c b/libq/atom.c
index 8ce7f18..170eeea 100644
--- a/libq/atom.c
+++ b/libq/atom.c
@@ -687,6 +687,7 @@ atom_to_string_r(char *buf, size_t buflen, depend_atom *a)
  * The possible "keywords" are:
  *  CATEGORY  P  PN  PV  PVR  PF  PR  SLOT  SUBSLOT  REPO  USE
  *    - these are all the standard portage variables (so see ebuild(5))
+ *    - any prefix of these (e.g. CAT, CA, C) will match as well
  *  pfx - the version qualifier if set (e.g. > < = !)
  *  sfx - the version qualifier if set (e.g. *)
  */

Reply via email to