added conditional section documentation
Fixed typos.

Fixed the conditional-section example and added a test for it.

Added some more details about option overridding.
Merge pull request #104 from buildout/jim-condition-section-doc

added conditional section documentation