Summary: | Handbook Comments | ||
---|---|---|---|
Product: | [OLD] Docs on www.gentoo.org | Reporter: | Kevin Grigorenko <kevin.grigorenko> |
Component: | Installation Handbook | Assignee: | nm (RETIRED) <nightmorph> |
Status: | RESOLVED FIXED | ||
Severity: | normal | CC: | docs-team |
Priority: | High | ||
Version: | unspecified | ||
Hardware: | AMD64 | ||
OS: | Linux | ||
URL: | http://www.gentoo.org/doc/en/handbook/handbook-amd64.xml?style=printable&full=1 | ||
Whiteboard: | |||
Package list: | Runtime testing required: | --- |
Description
Kevin Grigorenko
2010-06-10 00:44:24 UTC
1. -march=native is much harder to implement, since we would need to make some extensive changes with how we program our handbooks. However, I did update it to -march=core2, rather than the old P4-era nocona. 2. The code listing is correct; this is auto-generated from the part, chapter, and sections listed. We never put in numbers; our xml/xsl interpreter and webserver compute this automatically. Try viewing it in the separate pages, rather than the all-in-one view, to see how parts, chapters, and sections are assigned. http://www.gentoo.org/doc/en/handbook/handbook-amd64.xml?part=1&chap=5 The numbers in the big bold black text sections don't have any relation to the stuff beneath them. Those are considered chapters, and for each of those chapters, the numbers of code listings and whatnot beneath them are counted uniquely, starting over with each new chapter. A better example of how chapters work might be one of our other documents, such as: http://www.gentoo.org/doc/en/xfce-config.xml In this case, the chapters line up because they're all on one page, and the doc is only composed of those chapters. The handbooks have a different structure than the one-page guides. The renumbering follows the same principle, but there are higher-level divisions than just chapters, hence the numbering not always following along. 3. I fixed the MCE description. Seems that's changed a bit in recent kernels. Thanks for the suggestions! |