Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 235699 - The gentoo java upgrade guide uses out of date portage syntax
Summary: The gentoo java upgrade guide uses out of date portage syntax
Status: RESOLVED FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Project-specific documentation (show other bugs)
Hardware: All Linux
: High enhancement (vote)
Assignee: nm (RETIRED)
URL: http://www.gentoo.org/proj/en/java/ja...
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2008-08-25 18:10 UTC by Shaun Bouckaert
Modified: 2008-08-25 19:27 UTC (History)
1 user (show)

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 Shaun Bouckaert 2008-08-25 18:10:20 UTC
The java upgrade guide uses the following syntax for emerging both versions of java-config

# emerge -1 "=java-config-1*" "=java-config-2*"

when it would be better to use the new slots syntax

# emerge -1 java-config:0 java-config:2

Reproducible: Always

Steps to Reproduce:
1. Visit the provided URL
2. Go to section 2, code listing 2.2
Actual Results:  
Recommends the use of:
# emerge -1 "=java-config-1*" "=java-config-2*"

Expected Results:  
Should recommend the use of:
# emerge -1 java-config:0 java-config:2

I believe gentoo documentation should be trying to use the new syntax where possible, as it is cleaner than the old syntax, and helps new users understand slots better.
Comment 1 Wormo (RETIRED) gentoo-dev 2008-08-25 18:35:29 UTC
Thanks for the report, sounds like a good suggestion.

Assigning to the editor of the document with authors CC-ed, since this seems like an editorial type of change.
Comment 2 nm (RETIRED) gentoo-dev 2008-08-25 19:27:35 UTC
Thanks for reporting. Fixed in CVS.

In the future, bugs against documentation should be assigned to the owning project, not the original author(s). Authors can come and go, but maintainers are forever. Kinda.

In this case, since it's a project doc, it would be assigned to java@g.o -- docs in /proj/ belong to that particular project or subproject. Docs in /doc/ belong to the GDP; docs-team@g.o.