Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 595992 - Random ramblings about docs
Summary: Random ramblings about docs
Status: RESOLVED INVALID
Alias: None
Product: Websites
Classification: Unclassified
Component: Wiki (show other bugs)
Hardware: All Linux
: Normal normal (vote)
Assignee: Frank Daniel
URL:
Whiteboard:
Keywords:
: 595972 (view as bug list)
Depends on:
Blocks:
 
Reported: 2016-10-02 22:43 UTC by Frank Daniel
Modified: 2016-10-11 04:46 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 Frank Daniel 2016-10-02 22:43:29 UTC
emerge --ask sys-kernel/
Comment 1 Frank Daniel 2016-10-02 22:48:09 UTC
Tried to use "emerge --ask sys-kernel/" to emerge the gentoo kernel source per instruction.  

"For amd64-based systems Gentoo recommends the sys-kernel/ package.

Choose an appropriate kernel source and install it using emerge:
root #emerge --ask sys-kernel/
Comment 2 Adam Feldman gentoo-dev 2016-10-03 01:48:14 UTC
build.log and emerge --info please
Comment 3 Adam Feldman gentoo-dev 2016-10-03 02:11:53 UTC
(In reply to Frank Daniel from comment #0)
> emerge --ask sys-kernel/

Ah, I see what you are saying.

Don't worry about emerge --info  or a build log.




"sys-kernel/{{#show: Handbook:{{ROOTPAGENAME}}|? kernel-sources}}"
is resolving to "sys-kernel/" for AMD64 only (afaics)
Comment 4 Adam Feldman gentoo-dev 2016-10-03 06:54:26 UTC
(In reply to Frank Daniel from comment #1)
> Tried to use "emerge --ask sys-kernel/" to emerge the gentoo kernel source
> per instruction.  
> 
> "For amd64-based systems Gentoo recommends the sys-kernel/ package.
> 
> Choose an appropriate kernel source and install it using emerge:
> root #emerge --ask sys-kernel/

in the mean time, to complete your install, emerge sys-kernel/gentoo-sources
Comment 5 Matthew Marchese Gentoo Infrastructure gentoo-dev 2016-10-03 15:23:10 UTC
Frank, thanks for reporting this. For future submissions: the bug description of "AMD64 Handbook/Installation/Kernel" is somewhat helpful. It is best to add a URL to the appropriate documentation location in the bug description. This field should be used when dealing with documentation that's available on the web. Helps the wiki/docs team quickly find the offending page/article.

NP - Thanks for helping this user and for the IRC notification; I generally don't check e-mail as much as I should.

The problem should now be resolved; I rebuilt the wiki's database. Reopen if you still experience and offense.
Comment 6 Matthew Marchese Gentoo Infrastructure gentoo-dev 2016-10-03 15:23:59 UTC
*** Bug 595972 has been marked as a duplicate of this bug. ***
Comment 7 Alex Legler (RETIRED) archtester gentoo-dev Security 2016-10-03 17:32:10 UTC
(In reply to Matthew Marchese from comment #5)
> The problem should now be resolved; I rebuilt the wiki's database. Reopen if
> you still experience and offense.

That's merely a temporary workaround for the underlying issue.

To properly fix it, the next wiki software update will have another way of storing data like handbook strings.
Comment 8 Frank Daniel 2016-10-05 01:31:00 UTC
I have already pass those problems as I have installed Gentoo a few times.  It would appear that someone need to proof read and actually attempt the instructions as a newbee and comment on the documentation.
Actually, this is very likely need for all the documentation.  I have been confused at times with the present set of documentation.
Comment 9 Alex Legler (RETIRED) archtester gentoo-dev Security 2016-10-05 11:08:38 UTC
(In reply to Frank Daniel from comment #8)
> I have already pass those problems as I have installed Gentoo a few times. 
> It would appear that someone need to proof read and actually attempt the
> instructions as a newbee and comment on the documentation.

This bug you filed concerns a technical issue with the wiki software, not one regarding document quality. Please stay on topic.

> Actually, this is very likely need for all the documentation.  I have been
> confused at times with the present set of documentation.

Please feel free to use the discussion pages of the relevant articles to express your concerns.
Comment 10 Frank Daniel 2016-10-06 23:24:03 UTC
No, I disagree.  This problem is systemic with all of the documentation. There is little or no coition between the sections.  It appears that no ones has corrugated the basic units such as systemd, grub, xorg etc. 
Google helps, but leads to many false trails.
Comment 11 Alex Legler (RETIRED) archtester gentoo-dev Security 2016-10-07 05:55:18 UTC
(In reply to Frank Daniel from comment #10)
> No, I disagree.  This problem is systemic with all of the documentation.
> There is little or no coition between the sections.  It appears that no ones
> has corrugated the basic units such as systemd, grub, xorg etc. 
> Google helps, but leads to many false trails.

This is nothing you can file a bug about. Apart from the handbook, the wiki is a collaboration effort of our community. I pointed out ways to improve that, filing a bug is not an option.

As you keep derailing the topic, I'll be using another bug to track the actual issue.
Comment 12 Frank Daniel 2016-10-10 20:53:01 UTC
Watch here for new development.
This is still a bug for continuity of the whole tamale
Comment 13 Alex Legler (RETIRED) archtester gentoo-dev Security 2016-10-11 04:46:10 UTC
(In reply to Frank Daniel from comment #12)
> Watch here for new development.
> This is still a bug for continuity of the whole tamale

Knock yourself out.