I really like the well-commented xorg.conf.example that used to get emerged with X. I don't know if it got lost in the shuffle of modularization or it's actually around and I just can't find it and am wasting your time (I hope not, I've looked pretty hard and asked around on #gentoo) but perhaps the configuration file could be grabbed as part of xorg-x11. If the file isn't included for strong reasons then please file this as a documentation bug. According to the xorg configuration guide: 3. Configuring Xorg The xorg.conf File The configuration file of Xorg is called xorg.conf and it resides in /etc/X11. The Xorg-X11 package provides an example configuration as /etc/X11/xorg.conf.example which you can use to create your own configuration. It is heavily commented, but if you are in need of more documentation regarding the syntax, don't hesitate to read the man page...
Yes it would be nice to install this. The unprocessed form is still distributed in xorg-server as hw/xfree86/xorgconf.cpp but it appears there's no rule to generate the final example file.
Josh, would you like to take a look at this?
Sure, I'll try to get a patch together today.
Created attachment 98419 [details, diff] xorg-conf-example.patch Patch was slightly more involved than I anticipated. This will cause xorg.conf.example to be built under the hw/xfree86 directory.
Created attachment 98420 [details, diff] xorg-server.patch Patch to xorg-server-1.1.1-r1.ebuild required to properly build and install xorg.conf.example.
Created attachment 98421 [details] xorg.conf.example Example xorg.conf.example output for reference.
Created attachment 98424 [details, diff] xorg-conf-example.patch Updated patch. Implements Donnie's suggestion of using cpprules.in to save some code duplication.
Josh, would you like to commit this to 1.1.1-r1?
Created attachment 99337 [details, diff] xorg-conf-example.patch Removed speedo fonts per Donnie's request. This will be the version committed unless other problems arise.
Fixed in CVS.