[Mesa-dev] [PATCH v3] docs: expand "all drivers" to the list of drivers.

[Emil Velikov]

On 14 April 2016 at 16:48, Romain Failliot <romain.failliot at foolstep.com> wrote:
> Hi Emil!
>
> Actually this patch is less about mesamatrix and more about cleaning
> the file (IMO).
> By replacing "all drivers" with the actual list of drivers, I've
> noticed that it was easier to see which drivers are actually completed
> or not.
>
> I also think this will be problematic when new drivers are added. I've
> heard about OpenSWR recently that is apparently an alternative to
> llvmpipe, I guess this driver could be added in this file, doesn't it?
> Here, the "all drivers" lines will activate GL extensions for this new
> driver whether it's true or not.
>
> I completely understand that this file is mainly meant for the devs.
> But from what I've seen, even the devs themselves aren't sure about
> the meaning of some lines in this file (I remember previous emails
> where I asked the difference between "DONE" and "DONE ()" and not
> everyone agreed on the signification ;)). So, to me, structuring this
> file is not just for mesamatrix but also for the global understanding
> of everyone.
>
So the issue boils down to the confusion cause by "DONE" vs "DONE ()"
? That's easy.

Former implies that there is no driver support needed, while the
latter that there is (with the drivers already having support in the
list). Obviously anyone working is likely to check the driver
themselves ;-)

> I hope I'll be of more help in the future. Right now it's GL3.txt and
> mesamatrix, later it might be drivers optimizations ;)
>
So docs/ is unlikely to get any love, sob ;-(

-Emil