Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 437338 - Various suggestions for the Handbook
Summary: Various suggestions for the Handbook
Status: RESOLVED FIXED
Alias: None
Product: [OLD] Docs on www.gentoo.org
Classification: Unclassified
Component: Installation Handbook (show other bugs)
Hardware: AMD64 Linux
: Normal minor (vote)
Assignee: Sven Vermeulen (RETIRED)
URL: http://www.gentoo.org/doc/en/handbook...
Whiteboard:
Keywords:
: 436584 (view as bug list)
Depends on:
Blocks:
 
Reported: 2012-10-05 20:11 UTC by Francesco Turco
Modified: 2013-12-18 10:14 UTC (History)
6 users (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 Francesco Turco 2012-10-05 20:11:01 UTC
http://www.gentoo.org/doc/en/handbook/handbook-amd64.xml?part=1&chap=4#doc_chap2
"This isn't always the case though, so YMMV." <-- Perhaps it's better to avoid acronyms like YMMV. I had to search Google for understanding its meaning.

http://www.gentoo.org/doc/en/handbook/handbook-amd64.xml?part=1&chap=4#doc_chap4
I suggest to use the MiB unit in parted instead of MB in order to avoid alignment issues and warnings. It seems that mebibyte alignment is now a general purpose standard for partitions.

http://www.gentoo.org/doc/en/handbook/handbook-amd64.xml?part=1&chap=8#doc_chap1
The handbook says the fifth field in the fstab file should be set to 0, but immediately after it uses value 1 for the /boot partition but provides no explanation for that.

http://www.gentoo.org/doc/en/handbook/handbook-amd64.xml?part=3&chap=6#doc_chap1
"If you have need for more specific tweaks and tips, you might find them on the Gentoo WiKi instead." <-- It should be "Gentoo Wiki" instead (no need for an uppercase K).

http://www.gentoo.org/doc/en/handbook/handbook-amd64.xml?part=3&chap=6#doc_chap6
"for instance because a developer asked you to to support you in a bug you reported" <-- I simply can't parse this phrase.

Reproducible: Always
Comment 1 Sven Vermeulen (RETIRED) gentoo-dev 2012-10-06 20:23:28 UTC
Okay; all of the except the alignment have been fixed in CVS (so should show up on the site in an hour or so).

@ architecture teams, is it ok if the installation instructions using parted would use megabytes (excuse me, mebibytes) alignment?

The instructions would then most likely use the start-command "parted -a optimal /dev/sda" and set the units to mebibytes ("unit MiB"). The first partition would also then start at 1 MiB (instead of 512K) as I believe there was another bug on this regarding GRUB2 requiring a larger space before the first partition.

@ Francesco: thanks for reporting this! Much appreciated
Comment 2 Sven Vermeulen (RETIRED) gentoo-dev 2012-10-31 18:40:11 UTC
*** Bug 436584 has been marked as a duplicate of this bug. ***
Comment 3 Sven Vermeulen (RETIRED) gentoo-dev 2013-12-18 10:14:35 UTC
Ok done for x86 and amd64. Other arches should ping me/open bug if their architecture-specific instructions need to be changed.