Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 126946 - misleading use of equery
Summary: misleading use of equery
Status: RESOLVED FIXED
Alias: None
Product: [OLD] Docs on www.gentoo.org
Classification: Unclassified
Component: Installation Handbook (show other bugs)
Hardware: x86 Linux
: High normal (vote)
Assignee: Docs Team
URL: 1
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2006-03-20 05:37 UTC by Tom Taylor
Modified: 2006-09-04 04:30 UTC (History)
1 user (show)

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 Tom Taylor 2006-03-20 05:37:35 UTC
Might just be my lack of reading ability:-) but it appears from the handbook that after emerge'ing gentoolkit, you can use equery uses as a direct replacement for emerge -pv for packages that are not yet installed.
Comment 1 nm (RETIRED) gentoo-dev 2006-03-20 11:28:49 UTC
What exactly are you suggesting? Please be more clear. Your bug summary suggests one thing, while your description says another, and it isn't clear what you mean. The Portage handbook touches on some possible uses of equery, but equery certainly isn't a replacement for emerge -pv!
Comment 2 Jakub Moc (RETIRED) gentoo-dev 2006-03-20 15:41:08 UTC
Well, 'equery uses' is completely useless for checking available use flags unless you have the relevant ebuild already merged. The only thing it produces is:

[ Searching for packages matching apache... ]
!!! No matching packages found for "apache"

So, 

"now run equery with the uses argument to view the USE-flags of a certain package. For instance, for the gnumeric package"

doesn't make much sense unless you have already that ebuild installed, and at that point you usually don't want to check for use flags, it's too late. 
Comment 3 Xavier Neys (RETIRED) gentoo-dev 2006-03-21 02:51:30 UTC
You need the -a flag on equery, eg. equery uses =kde-base/akregator-3.5.1 -a

emerge -vp is easier, displays the packages it would install and their use flags.

equery uses ... would display all versions of a single package only, you need to provide a full atom if you want the latest version.
The only advantage of equery is that it displays the USE flag descriptions
Comment 4 Tom Taylor 2006-03-21 03:04:16 UTC
From the page http://www.gentoo.org/doc/en/handbook/handbook-x86.xml?part=2&chap=2
(USE Flags), Section 2.c makes it appear that you can use equery uses
to check the use-flags of a package (which is correct), but does not
mention that you need to have built the package...

<quote>
Let us take the example of mozilla: what USE-flags does it listen to?
To find out, we use emerge with the --pretend and --verbose options:
<code snippet />
emerge isn't the only tool for this job. In fact, we have a tool
dedicated to package information called equery which resides in the
gentoolkit package. First, install gentoolkit:
<code snippet />
Now run equery with the uses argument to view the USE-flags of a
certain package. For instance, for the gnumeric package:
</quote>

Although (admittedly) it follows the section on actually building the
package, it can easily be taken out of context (well I did it).
Comment 5 Xavier Neys (RETIRED) gentoo-dev 2006-03-21 03:11:36 UTC
In case you haven't noticed, the bug has been reopened.
Comment 6 Jakub Moc (RETIRED) gentoo-dev 2006-03-21 03:17:21 UTC
(In reply to comment #3)
> You need the -a flag on equery, eg. equery uses =kde-base/akregator-3.5.1 -a
> 
> emerge -vp is easier, displays the packages it would install and their use
> flags.

Well yeah,  I'm aware of -a option, but it's not suggested to use that in the guide and besides, it floods you w/ pretty verbose use flags output for every single version of that ebuild in portage - may be useful for specific purposes but  emerge -pv is really what I'd prefer here. Nothing major anyway. 
Comment 7 Łukasz Damentko (RETIRED) gentoo-dev 2006-09-04 04:30:02 UTC
I've added -a and =version there.