Bug 437338 – Various suggestions for the Handbook

• Product: [OLD] Docs on www.gentoo.org
• Status: RESOLVED FIXED

[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) 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) 2012-10-31 18:40:11 UTC]

*** Bug 436584 has been marked as a duplicate of this bug. ***

[Comment 3 Sven Vermeulen (RETIRED) 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.