The documentation for the Display section of xorg.conf can be summarized in one sentence. Don't be messin' with it
Seriously, Matthew has posted a few times that the direction is to get driver configuration options from amdpcsdb and to use Xorg.conf for configuring the rest of the X system. Part of the installation process involves running aticonfig to initialize the amdpcsdb file and from that point on configuration changes should be done using aticonfig or cccle. There may be a couple of exceptions to this and if so I agree we need to get them properly documented.
There are a few things on my list of "questions to ask Matthew next time I see him *and* remember the list" :
- does aticonfig --initial do anything to xorg.conf or does it only change admpcsdb ?
- are there any configuration options which are currently configurable only through xorg.conf, or should we be using aticonfig (and hence amdpcsdb) for everything already ?
- would it be possible to make the option handling a bit more verbose, particularly in the case where there is a conflict between xorg.conf and amdpcsdb entries ? Not sure this is necessary though, since it is only an issue if you have xorg.conf Display options and in general we are recommending that you do not...
I should probably mention again that this thread is specifically for accumulating questions to the ati devs, but I think we've all pretty much given up on any hope of thread discipline anyways