<snip> Important: The default /etc/fstab file provided by Gentoo is not a valid fstab file. You have to create your own /etc/fstab. ... Code Listing 1.3: A *full* /etc/fstab example /dev/sda1 /boot ext2 defaults,noatime 1 2 /dev/sda2 none swap sw 0 0 /dev/sda3 / ext3 noatime 0 1 /dev/cdrom /mnt/cdrom auto noauto,user 0 0 </snip> Nice. Now the users have just killed this vital part: # glibc 2.2 and above expects tmpfs to be mounted at /dev/shm for # POSIX shared memory (shm_open, shm_unlink). # (tmpfs is a dynamically expandable/shrinkable ramdisk, and will # use almost no memory if not populated with files) shm /dev/shm tmpfs nodev,nosuid,noexec 0 0 And then they go filing invalid bugs such as bug 299777. The example there breaks anything what relies on shm_open() and shm_unlink(), such as www-client/chromium or any application that happens to use pulseaudio, and more.
Did ya miss the bit in there about "Now use the *example* below to create your /etc/fstab" and the big ol' "Important:" box above CL 1.1? If people can't be arsed to actually read the text in the /etc/fstab we ship with each tarball, then duplicating it in the docs won't help. RESO WORKSFORME, unless some other member of the GDP wants to change it.
(In reply to comment #1) > If people can't be arsed to actually read the text in the /etc/fstab we ship > with each tarball, then duplicating it in the docs won't help. > > RESO WORKSFORME, unless some other member of the GDP wants to change it. The example is WRONG for all glibc based boxes. So it is not that people can't be arsed, you are missing a vital line there that should be present everywhere. So, your "full" fstab breaks people's boxes functionality. Also, you explicitely say there "the default /etc/fstab file provided by Gentoo is not a valid fstab" - so you make people think Gentoo ships bogus crap there, where in fact the only thing needed to adjust there is the ROOT/BOOT/SWAP placeholders, while the docs suggest "you have to create your own /etc/fstab" Reopen.
side note: /dev/shm is required only for baselayout-1 ... openrc makes sure it is mounted regardless of what users do