On Jul 15, 2008, at 3:09 PM, Chris Withers wrote:

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.

You are referring to: 
http://pypi.python.org/pypi/zc.buildout/1.0.6#adding-and-removing-options


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

The last example extends extensions2.cfg, which extends extensions1.cfg.

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

Yup. That's annoying. This section should be moved until after extending has been described and should use an extension. Probably just invoking the buildout with -vv should be enough. I'm hoping the person who wrote this section is paying attention so I don't have to fix this myself. :)



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'

Right.

when extension1.cfg is used, but there's no explanation of how this works. Are option values always split on spaces

Yes

or is there another set of rules for this?

No.

Where is this documented?

That section tries to explain it. The parsing rule should have been stated. The example should be made simpler. The extension business complicates it excessively.

Jim

--
Jim Fulton
Zope Corporation


_______________________________________________
Distutils-SIG maillist  -  [email protected]
http://mail.python.org/mailman/listinfo/distutils-sig

Reply via email to