The current document correctly outlines the installation of X, but it leaves out a simple step that could save users lots of time. Every time I go through the installation it fails on whatever package (I forget, some Gtk package I think) because it has to have Cairo compiled with the X use flag. So I suggest to ask the user to do something like: echo 'X11-libs/cairo X' >> /etc/portage/package.use before emerge xorg-x11. Reproducible: Always Steps to Reproduce: 1. Follow guide to install X. Actual Results: It fails after realizing Cairo doesn't have X use flag. Expected Results: It should go through without this error.
In our desktop installation guides, we already talk about the importance of setting X globally in /etc/make.conf, which would take care of it. If you're installing a desktop, X should be in make.conf, not package.use, and our desktop guides already have the instructions for this. Also, if you're using the desktop profile (which I believe has been the default for a couple of releases now), you will automatically have X in your USE flags. Additionally, the ebuild itself warns of setting X for cairo, so there's plenty of existing notifications that you should have set X. No point in mentioning a single gtk library that may or may not ever be installed in the Xorg configuration document.
(In reply to comment #1) > In our desktop installation guides, we already talk about the importance of > setting X globally in /etc/make.conf, which would take care of it. Its only mentioned in the Gnome and Xfce install document. Needless to say at this point I didn't use that with Fluxbox. > Also, if you're using the desktop profile (which I believe has been the default > for a couple of releases now), you will automatically have X in your USE flags. Must not be in mine :( > Additionally, the ebuild itself warns of setting X for cairo, so there's plenty > of existing notifications that you should have set X. It doesn't warn, it fails. > No point in mentioning a single gtk library that may or may not ever be > installed in the Xorg configuration document. We would not be mentioning a single Gtk library. The point here is your going to read and follow the X document before you read any of the documentation regarding setting up your desktop. By the time I get the Gnome or Xfce or Fluxbox install it'll be to late by that point and it will have already failed. Even if you don't use that gtk package in a KDE install, the flag will already be set and it will make so difference either way. For the rest of us non-KDE users it will serve as a valid purpose. Xfce by the way requires gtk+-2.6. As do most gtk+ applications you'll probably use anyway like Gvim, Pidgin, etc.
