I re-read the AMD64 Gentoo Handbook and I found some improvements that can be made. 1) Part 1, chapter 2. There are two columns for the table, one for the minimal CD and the other one for the Live CD. As far as I know the Live CD doesn't exist anymore, and should be removed. 2) Part 1, chapter 4. GPT/parted should be used for partitions bigger than 2 TiB, not TB. A 2 TB hard disk can still be partitioned with MSDOS labels and fdisk as 2 TB < 2 TiB. 3) Part 1, chapter 4. There's a reference to OpenOffice. It should be LibreOffice instead because OpenOffice is not in the Portage tree anymore. 4) Part 1, chapter 4. "However, make sure you do not make any mistakes here - parted executes the changes immediate (...)". This is a typo: it should be "immediately". 5) Part 1, chapter 4. "If you intend to install Gentoo on a very small disk (less than 4GB) [...] You can tune this even further by using mke2fs -i <ratio> /dev/<device>." is repeated two times, one for ext2 and the other for ext3. I think it's better to write it only once, perhaps in the following section ("Applying a filesystem to a partition"). Also it probably applies to ext4 as well, and writing it three times doesn't make sense. 6) Part 1, chapter 5. "The following example is just an example". "example" is repeated twice. Perhaps "The following one is just an example" is better. 7) Part 1, chapter 5. The link to the Compilation Optimization Guide is a redirect to the wiki. A direct link would be better. 8) Part 1, chapter 6. The SYNC variable in make.conf is obsolete. /etc/portage/repos.conf/gentoo.conf should be used instead. 9) Part 1, chapter 10. "Important: If you are using a non-multilib profile, you should not emerge grub, but instead you should emerge grub-static. If you plan to use a non-multilib profile and you have disabled IA-32 emulation in your kernel, then you should use lilo." My system is no-multilib, IA-32 is disabled but I use GRUB2 instead of lilo without any problems. 10) Part 2, chapter 3. The link to the Distcc guide is a redirect to the Gentoo wiki. A direct link is better in my opinion. 11) Part 2, chapter 3. "Even though Gentoo does not provide prebuilt packages by itself (except for the GRP snapshots) Portage can be made fully aware of prebuilt packages." As far as I know GRP snapshots aren't there anymore. 12) Part 2, chapter 3. As for 8): The SYNC variable in make.conf is obsolete. /etc/portage/repos.conf/gentoo.conf should be used instead. 13) Part 3, chapter 1. I don't have the /etc/make.globals file on my system. I think the right location is /usr/share/portage/config/make.globals. Reproducible: Always
On (1): Yes, but there is a LiveDVD. I've just substituted the name as we will have more LiveDVD releases as time goes by.
On (2) Seems to already be in place in the handbook now (I read 2 TB everywhere).
On (3) Thanks, fixed in CVS.
On (4) Thanks, fixed
On (5) Thanks, fixed
On (6) Thanks, fixed
On (7) and (10) I've updated all links in the handbook that I could find which lead to the wiki.
On (8) Thanks, I was actually not aware of this :-( Fixed now.
On (10) You were reading the "GRUB Legacy" part. If you use GRUB2, then this part does not apply to you. Still, I've reworded the paragraph a bit to make it more clear.
Previous is (9) not (10) On (11), indeed, fixed in CVS.
(12) was fixed together with (8) (13) is now fixed in CVS as well Thank you very much for the feedback!
