Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 219290 - PROVIDE variable is deprecated
Summary: PROVIDE variable is deprecated
Status: RESOLVED WONTFIX
Alias: None
Product: Documentation
Classification: Unclassified
Component: Devmanual (show other bugs)
Hardware: All Linux
: High normal
Assignee: Gentoo Quality Assurance Team
URL: http://devmanual.gentoo.org/ebuild-wr...
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2008-04-25 18:59 UTC by Michel Filipe
Modified: 2008-05-19 07:25 UTC (History)
2 users (show)

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


Attachments
Remove PROVIDE variable (variables.xml.patch,509 bytes, patch)
2008-04-25 19:00 UTC, Michel Filipe
Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description Michel Filipe 2008-04-25 18:59:16 UTC
I write a patch to ebuild-writing/variable/text.xml removing the PROVIDE variable.
Comment 1 Michel Filipe 2008-04-25 19:00:15 UTC
Created attachment 150970 [details, diff]
Remove PROVIDE variable
Comment 2 Mark Loeser (RETIRED) gentoo-dev 2008-04-25 19:47:32 UTC
I can't find anything that indicates it is deprecated.

Portage and pms guys: comments?
Comment 3 Michel Filipe 2008-04-25 19:51:29 UTC
[15:33] <trops> are the virtual ebuilds I add in PROVIDE variable?
[15:33] <dberkholz> trops: no, you don't need to do that
[15:34] <dberkholz> that's more for old-style virtuals
[15:34] <dberkholz> the kind that show up in virtuals files in the profiles/ directory, rather than the kind in the virtuals/ category
[15:36] <trops> dberkholz: in documentation http://devmanual.gentoo.org/ebuild-writing/variables/index.html say that I add in PROVIDE variable
[15:36] <trops> however, thanks! :D
[15:37] <dberkholz> devmanual's out of date on that
[15:37] <dberkholz> feel free to submit a patch =)
[15:37] <trops> ok :) I will write a patch :D
[15:44] <trops> dberkholz: Is the PROVIDE variable deprecated?
[15:44] <dberkholz> i'd say that everything related to old-style variables is
Comment 4 Ciaran McCreesh 2008-04-25 19:51:44 UTC
PROVIDE is for old style virtuals. New style virtuals don't use it.

But alas, old style virtuals have yet to be formally deprecated.
Comment 5 Michel Filipe 2008-04-25 20:03:38 UTC
Allright, this patch will apply in future. :P
Comment 6 Bo Ørsted Andresen (RETIRED) gentoo-dev 2008-04-26 08:13:00 UTC
Old style virtuals cannot be deprecated currently. See bug #148251
Comment 7 Bo Ørsted Andresen (RETIRED) gentoo-dev 2008-04-26 08:16:18 UTC
(In reply to comment #1)
> Created an attachment (id=150970) [edit]
> Remove PROVIDE variable

Mmm.. the examples in this snippet are bad though. Both editor and emacs have been converted to new style virtuals a while ago..
Comment 8 Mark Loeser (RETIRED) gentoo-dev 2008-05-19 01:39:49 UTC
Nothing to do here.  Every time something in the tree changes I don't plan on updating the examples in devmanual.  If someone thinks we should, then maybe we should just make all of the examples abstract so it doesn't represent anything in the tree, but that would be a separate bug.
Comment 9 Bo Ørsted Andresen (RETIRED) gentoo-dev 2008-05-19 07:25:59 UTC
Well, currently new style virtuals aren't even mentioned at all in the devmanual despite that they are preferred whenever possible.

Probably, what really should happen is that profiles/virtuals/index.html should explain the distinction between old and new style virtuals, in which cases we still have to use old style (self-blocking virtuals such as e.g. mta) and in which cases it's particularly useful to convert existing virtuals to new style (e.g. SLOT/version specs needed)...

In the variables section there should be a reference to that page and s/Any virtuals/Any old style virtuals/.