Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 92617 - "Stub Packages" vs. "Metapackages"
Summary: "Stub Packages" vs. "Metapackages"
Status: RESOLVED FIXED
Alias: None
Product: [OLD] Docs-user
Classification: Unclassified
Component: Handbook (show other bugs)
Hardware: All All
: Lowest enhancement (vote)
Assignee: Xavier Neys (RETIRED)
URL: http://www.gentoo.org/doc/en/handbook...
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2005-05-14 10:16 UTC by Jan Kundrát (RETIRED)
Modified: 2005-05-17 07:41 UTC (History)
2 users (show)

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


Attachments
Patch changing stub packages to metapackages (hb-working-portage.diff,287 bytes, patch)
2005-05-14 11:12 UTC, Sean D. Quinn
Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description Jan Kundrát (RETIRED) gentoo-dev 2005-05-14 10:16:26 UTC
IMHO Handbook should call "stub packages" like kde-base/kde "metapackages", as it better fitts their purpose.

The only place where "stub package" occurs in docs is $URL (handbook/hb-working-portage.xml).

KDE split ebuilds are complemented with "stub/meta" packages like kde-base/kde-meta, kde-base/kdepim-meta, not with kde-base/kdepim-stub :-).

I could make a patch if the is enough interest.

Comments?
Comment 1 Sean D. Quinn 2005-05-14 10:26:26 UTC
I like the idea. I'll patch up hb-working-portage.xml for it, but this is just my opinion.
Comment 2 Shyam Mani (RETIRED) gentoo-dev 2005-05-14 10:28:19 UTC
Just to clear any confusion....could someone be kind enough to explain :

a) What are stub packages?
b) What are meta packages?
c) What's the difference b/w the two? if any.

Thanks :)
Comment 3 Sean D. Quinn 2005-05-14 10:39:10 UTC
Stub packages are packages that are kind of like symbolic links. An example would be typing "emerge gnome" or "emerge kde". There is no real 'gnome' or 'kde' to install, and the packages has very little, if any content but the purpose is to install the dependencies of the package to install the environment.

Meta packages are a brand-new-name for these packages. For KDE, a "stub package", some of the deps are complemented with meta. Therein which, there is no difference.
Comment 4 Jan Kundrát (RETIRED) gentoo-dev 2005-05-14 11:01:02 UTC
I think there's no difference in the names, I just like the name "metapackage" more.

Both of them referrs to some package which generally has no content, just dependencies.
Comment 5 Jonathan Smith (RETIRED) gentoo-dev 2005-05-14 11:08:48 UTC
note thate the developer handbook warns developers to not *DEPEND on "metapackages", and instead to depend only on specific libraries

thus, i believe we should use metapackage for consistancy
Comment 6 Sean D. Quinn 2005-05-14 11:12:03 UTC
Created attachment 58890 [details, diff]
Patch changing stub packages to metapackages
Comment 7 Jonathan Smith (RETIRED) gentoo-dev 2005-05-14 11:23:43 UTC
since this section explicetly mentions kde, should we mention split ebuilds for kde? the "kde" package really isn't a metapackage, as it installs all of kde itself without pulling in all of kde's packages individually. kde-meta, on the other hand, seems to be. see http://www.gentoo.org/doc/en/kde-split-ebuilds.xml

please correct me if i am wrong, as i don't use kde, but i am just remembering the guide...
Comment 8 Jan Kundrát (RETIRED) gentoo-dev 2005-05-14 12:03:02 UTC
I think that "metapackage" is the same as "stub package". Metapackage installs its dependencies and nothing else.
It doesn't matter whether you talk about hierarchy under kde (kdelibs, kdeadmin,...), kde-meta (kdepim-meta, ...) or kdepim-meta (kontact, kmail,...).
I think all those packages (not those in parentheses) could be considered metapackages.
Comment 9 Xavier Neys (RETIRED) gentoo-dev 2005-05-17 07:39:35 UTC
I prefer "metapackage" as well
Comment 10 Xavier Neys (RETIRED) gentoo-dev 2005-05-17 07:41:36 UTC
In CVS.