Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 113423 - equery: Unclear error message for package syntax
Summary: equery: Unclear error message for package syntax
Status: RESOLVED FIXED
Alias: None
Product: Portage Development
Classification: Unclassified
Component: Tools (show other bugs)
Hardware: All Linux
: High minor (vote)
Assignee: Portage Tools Team
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2005-11-23 20:09 UTC by Paul Varner (RETIRED)
Modified: 2006-01-17 19:22 UTC (History)
0 users

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Paul Varner (RETIRED) gentoo-dev 2005-11-23 20:09:08 UTC
From the gentoo-user mailing list:

I'm trying to learn equery since qpkg is being laid to rest.  However
I'm finding the hints that appear when you syntax is wrong very
confusing.

Her is an example:

  equery files --type vim

Gives  the expected results 

but if you add a version number things get very confusing


   equery files --type vim-6.3

 equery files --type vim-6.3
[ Searching for packages matching vim-6.3... ]
!!! Invalid syntax: missing operator
!!! If you want only specific versions please use one of
!!! the following operators as prefix for the package name:
!!!    >  >=  =  <=  <
!!! Example to only match gcc versions greater or equal 3.2:
!!!    >=sys-devel/gcc-3.2


OK following the example give doesn't work:

  equery files --type >=app-editors/vim-6.3
 -bash: =app-editors/vim-6.3: No such file or directory

OR

  equery files  >=app-editors/vim-6.3
 -bash: =app-editors/vim-6.3: No such file or directory

That was following EXACTLY the given directions.

It appears one needs to quote that kind of query like:
  equery files  ">=app-editors/vim-6.3"

So that is what the directions need to say.
Comment 1 Marius Mauch (RETIRED) gentoo-dev 2005-11-24 02:47:15 UTC
Hmm, do we really have to explain/work around bash functionality in error messages?
Comment 2 Paul Varner (RETIRED) gentoo-dev 2005-11-24 07:47:53 UTC
Normally, I would say no. However, since equery is being used by all levels of
user and the fact that even I forget occasionally. A short note with the error
message shouldn't hurt.  My proposed text reads:

!!! Note: The symbols > and < are used for redirection in the shell
!!! and must be quoted if either one is used.
Comment 3 Paul Varner (RETIRED) gentoo-dev 2006-01-17 19:22:37 UTC
Fix is in gentoolkit-0.2.1