Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 445184 - Portage world set should be prefixed with a @ sign in the installation handbook
Summary: Portage world set should be prefixed with a @ sign in the installation handbook
Status: RESOLVED INVALID
Alias: None
Product: [OLD] Docs on www.gentoo.org
Classification: Unclassified
Component: Installation Handbook (show other bugs)
Hardware: All Linux
: Normal trivial (vote)
Assignee: Docs Team
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2012-11-29 12:09 UTC by Francesco Turco
Modified: 2012-12-01 07:17 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 Francesco Turco 2012-11-29 12:09:26 UTC
In part 2 chapter 1 of the AMD64 installation handbook ("A Portage introduction") there are some references to the "world" set, but there is no @ sign prefix. As far as I know commands still work if you forget the @ sign, but it's deprecated syntax. emerge(1) man page says: "When used as arguments to emerge sets have to be prefixed with @ to be recognized."

In particular, in http://www.gentoo.org/doc/en/handbook/handbook-amd64.xml?part=2&chap=1#doc_chap3_sect5 there are 5 instances of "world" without the @ prefix. In http://www.gentoo.org/doc/en/handbook/handbook-amd64.xml?part=2&chap=1#doc_chap3_sect6 there is another instance, too.

Of course this bug is not AMD64 specific.

The file to edit is xml/htdocs/doc/en/handbook/hb-working-portage.xml.

Reproducible: Always
Comment 1 nm (RETIRED) gentoo-dev 2012-12-01 07:17:55 UTC
"world" is a special case; it's built into portage. also, sets with the @ prefix are a portage-2.2 feature, which is still hardmasked and thus not documented.