Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 84884 - [PATCH] Misc. use.[local.]desc enhancements
Summary: [PATCH] Misc. use.[local.]desc enhancements
Status: CONFIRMED
Alias: None
Product: Portage Development
Classification: Unclassified
Component: Enhancement/Feature Requests (show other bugs)
Hardware: All Linux
: High enhancement (vote)
Assignee: Portage team
URL:
Whiteboard:
Keywords: PATCH
: 127805 (view as bug list)
Depends on:
Blocks:
 
Reported: 2005-03-11 10:49 UTC by TGL
Modified: 2023-03-08 05:02 UTC (History)
4 users (show)

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


Attachments
pym/portage_use_desc.py (portage_use_desc.py,5.65 KB, text/plain)
2005-03-11 10:51 UTC, TGL
Details
emerge--portage_use_desc.patch (emerge--portage_use_desc.patch,4.15 KB, patch)
2005-03-11 10:52 UTC, TGL
Details | Diff
emerge--portage_use_desc.patch (emerge--portage_use_desc.patch,4.15 KB, patch)
2005-03-11 10:53 UTC, TGL
Details | Diff
equery--portage_use_desc.patch (equery--portage_use_desc.patch,3.13 KB, patch)
2005-03-11 10:54 UTC, TGL
Details | Diff
repoman--portage_use_desc.patch (repoman--portage_use_desc.patch,2.64 KB, patch)
2005-03-11 10:55 UTC, TGL
Details | Diff
use_desc_checker (use_desc_checker,1.17 KB, text/plain)
2005-03-11 10:57 UTC, TGL
Details
pym/portage_use_desc.py (portage_use_desc.py,5.62 KB, text/plain)
2005-10-25 10:00 UTC, TGL
Details
portage-2.0-svn20051024-use_desc-emerge.patch (portage-2.0-svn20051024-use_desc-emerge.patch,4.02 KB, patch)
2005-10-25 10:02 UTC, TGL
Details | Diff
portage-2.0-svn20051024-use_desc-repoman.patch (portage-2.0-svn20051024-use_desc-repoman.patch,2.47 KB, patch)
2005-10-25 10:03 UTC, TGL
Details | Diff
portage-2.0-svn20051024-use_desc-documentation.patch (portage-2.0-svn20051024-use_desc-documentation.patch,3.41 KB, patch)
2005-10-25 10:04 UTC, TGL
Details | Diff
gentoolkit-svn20051024-use_desc-equery.patch (gentoolkit-svn20051024-use_desc-equery.patch,2.56 KB, patch)
2005-10-25 10:05 UTC, TGL
Details | Diff
bin/use_desc_checker (use_desc_checker,1.90 KB, text/plain)
2005-10-25 10:07 UTC, TGL
Details
portage-2.1-pre5-use_desc-emerge.patch (portage-2.1-pre5-use_desc-emerge.patch,5.27 KB, patch)
2006-03-04 04:47 UTC, TGL
Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description TGL 2005-03-11 10:49:03 UTC
Hi,

I've wrote some bits of code for portage that allows easy access to use.[local.]desc files. The idea behind it follows some ML discussions [1,2] about per-package USE flags descriptions that would override the default global descriptions. I took the easiest-to-implement approach I could think of, which is to do that thanks to use.local.desc. Basically, if a dev wants to give a package-specific decsription for a flag because its behavior is a bit different than the usual one (or he wants to give some "that's a loss of functionnality" warnings, etc.), he just has to add an entry to use.local.desc, and this description will overrides the usual use.desc global one.

Users can see this special descriptions at emerge --pretend/--ask time if they use the --use-desc-special option. In additions, users who are also interested in seeing all local (resp. all local or global) USE flag descriptions can use the --use-desc-local (resp. --use-desc-all) option. The selected descriptions will appear summarized after the packages list. 

Parsing of use.[local.]desc files is done in a new portage module, "pym/portage_use_desc.py". I've also patched repoman and equery to use this module instead of their own code (i will CC portage-tools@ because of equery).

Ideas/comments/flames welcome (but maybe if it's about using some xml file)

[1] http://thread.gmane.org/gmane.linux.gentoo.portage.devel/618
[2] http://thread.gmane.org/gmane.linux.gentoo.devel/26035

Reproducible: Always
Steps to Reproduce:
Comment 1 TGL 2005-03-11 10:51:00 UTC
Created attachment 53193 [details]
pym/portage_use_desc.py
Comment 2 TGL 2005-03-11 10:52:02 UTC
Created attachment 53194 [details, diff]
emerge--portage_use_desc.patch

The emerge patch that adds --use-desc-* options. It's against 2.0.51.19.
Comment 3 TGL 2005-03-11 10:53:29 UTC
Created attachment 53195 [details, diff]
emerge--portage_use_desc.patch

Oops, no, sorry, that one...
Comment 4 TGL 2005-03-11 10:54:19 UTC
Created attachment 53196 [details, diff]
equery--portage_use_desc.patch

The patch for equery (gentoolkit-0.2.0).
Comment 5 TGL 2005-03-11 10:55:02 UTC
Created attachment 53197 [details, diff]
repoman--portage_use_desc.patch

The patch for repoman (2.0.51.19 again).
Comment 6 TGL 2005-03-11 10:57:23 UTC
Created attachment 53198 [details]
use_desc_checker

And a not that interesting small script i made to find flags that could be
candidate for beeing global or that have some special per-package descriptions.
Comment 7 Jason Stubbs (RETIRED) gentoo-dev 2005-07-28 07:24:50 UTC
Putting a hold on feature requests for portage as they are drowning out the 
bugs. Most of these features should be available in the next major version of 
portage. But for the time being, they are just drowning out the major bugs and 
delaying the next version's progress. 
 
Any bugs that contain patches and any bugs for etc-update or dispatch-conf can 
be reopened. Sorry, I'm just not good enough with bugzilla. ;) 
Comment 8 TGL 2005-10-25 10:00:53 UTC
Created attachment 71423 [details]
pym/portage_use_desc.py

iirc, no change but a s:\$Header:\$Id:
Comment 9 TGL 2005-10-25 10:02:57 UTC
Created attachment 71424 [details, diff]
portage-2.0-svn20051024-use_desc-emerge.patch

integration in emerge - updated for recent 2.0 SVN.
Comment 10 TGL 2005-10-25 10:03:54 UTC
Created attachment 71425 [details, diff]
portage-2.0-svn20051024-use_desc-repoman.patch

Cleanup of repoman - updated for 2.0 SVN
Comment 11 TGL 2005-10-25 10:04:53 UTC
Created attachment 71426 [details, diff]
portage-2.0-svn20051024-use_desc-documentation.patch

documentation of the new emerge options (man/emerge.1 and pym/emergehelp.py)
Comment 12 TGL 2005-10-25 10:05:46 UTC
Created attachment 71427 [details, diff]
gentoolkit-svn20051024-use_desc-equery.patch

Cleanup of equery - updated for recent SVN
Comment 13 TGL 2005-10-25 10:07:33 UTC
Created attachment 71428 [details]
bin/use_desc_checker

minor updates to the use{,.local}.desc checker (added --help, fix uncaught
exceptions)
Comment 14 TGL 2005-10-25 10:10:12 UTC
Reopening now that patches are up-to-date.
Comment 15 TGL 2006-03-04 04:47:40 UTC
Created attachment 81282 [details, diff]
portage-2.1-pre5-use_desc-emerge.patch

New version of the emerge integration patch. It is refactored to fit the recent changes made to depgrah.display(). It also adds a new option, "--use-desc-new", which prints descriptions of flags which are used for the first time by some packages (the yellow "flag%" ones).

Other patchs (documentation and repoman+equery cleanups) are probably out of sync too. I would happily update them if asked though.
Comment 16 Simon Stelling (RETIRED) gentoo-dev 2006-04-02 05:48:59 UTC
*** Bug 127805 has been marked as a duplicate of this bug. ***