Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 156649 - emerge man page incorrectly mentions command-line
Summary: emerge man page incorrectly mentions command-line
Status: RESOLVED FIXED
Alias: None
Product: Portage Development
Classification: Unclassified
Component: Documentation (show other bugs)
Hardware: All Linux
: High normal (vote)
Assignee: Portage team
URL:
Whiteboard:
Keywords: InVCS
Depends on:
Blocks:
 
Reported: 2006-11-29 12:52 UTC by Matus UHLAR - fantomas
Modified: 2007-07-30 01:07 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 Matus UHLAR - fantomas 2006-11-29 12:52:38 UTC
the emerge manual page says:

       USE  variables  may  be specified on the command line to override those
       specified in the default locations, letting you avoid using some depen-
       dencies  you  may not want to have.  USE flags specified on the command
       line are NOT remembered.  For example, USE="-X -gnome" emerge  mc  will
       emerge  mc  with those USE settings.  If you want those USE settings to
       be  more  permanent,  you  can  put  them  in  /etc/portage/package.use
       instead.

This seems to be incorrect. This is not how emerge processes the command line, it is feature of bourne-compatible shells (sh/ksh/bash/zsh/???) who set up USE environment variable with given content only for the 'emerge' command. This does not work in csh/tcsh and the 'emerge' does not process the 'USE="value ..."' command line option (unlike 'make' command).
Please, correct me if I'm wrong, or correct the 'emerge' manual page (or add the functionality) if I'm right.
Comment 1 Alec Warner (RETIRED) archtester gentoo-dev Security 2006-11-29 13:08:38 UTC
Reproduced on tcsh.
Comment 2 Zac Medico gentoo-dev 2006-11-29 15:25:34 UTC
We should probably note in the docs that package.use is the preferred way to alter  USE for a specific package (so that it persist for the next time the package is merged).  We can update the doc to say `env USE="-X -gnome" emerge mc` so that it's shell independent.
Comment 3 Matus UHLAR - fantomas 2006-12-11 00:59:08 UTC
that would be correct, even with the comment that bourne-compatible shells can set variables on command line without the 'env' command.

(even if package.use is preferred, I often play with setting different USE and running 'emrge -pv <package>' to see what would it do. repeated editing package.use would be superflous this way).
Comment 4 Arfrever Frehtes Taifersar Arahesis (RETIRED) gentoo-dev 2007-07-29 17:00:49 UTC
This bug seems to be fixed.