[Distutils] [zc.buildout] "Adding and removing options" section unclear

[Chris Withers]

Hi All,

This section of the docs at 
http://pypi.python.org/pypi/zc.buildout/1.0.6 doesn't seem to make much 
sense.

extension1.cfg and extension2.cfg are set up but no examples use them as 
far as I can see.

The demo also uses extending of configurations as well as buildout 
extensions before these have been introduced as concepts.

I'm *guessing* that:

 >>> write(sample_buildout, 'base.cfg',
... """
... [buildout]
... parts = part2
...
... [part2]
... recipe =
... option = b1 b2 b3 b4
... """)

 >>> write(sample_buildout, 'extension1.cfg',
... """
... [buildout]
... extends = base.cfg
...
... [part2]
... option -= b1 b2
... """)

..will result in 'option' being 'b3 b4' when extension1.cfg is used, but 
there's no explanation of how this works. Are option values always split 
on spaces or is there another set of rules for this? Where is this 
documented?

cheers,

Chris

-- 
Simplistix - Content Management, Zope & Python Consulting
            - http://www.simplistix.co.uk