imageworks/OpenColorIO — pull request #296 by dbr (2012-12-08 06:33:25+00:00)
Title: docs: WIP "Config Syntax" docs

Don't merge this yet, as its incomplete.. Pull-requesting to supersede the #294, so any discussion doesn't get spread out

I've started documenting the config format, in a "what do each of these values do?" kind of way.

Everything interesting is in the `config_syntax.rst` file. Should be pretty readable in raw form, but I'll update my gh-pages branch later, if I remember..

There's a few bits I had to guess what they do by prodding around in the code, as I'd never really used them.

@jeremyselan Can you confirm what's written so far is in keeping with the original intent of each option?

Particularly, I kind of guessed about the following (from memory and grep'ing around the code):

- the intent/usage of `strictparsing`
- the cases in which `luma` are used (like, it doesn't impact the CDLTransform)

Also I couldn't think of a more concise description of the `ocio_profile_version` and `roles`