Commit c7cd54e7 authored by Jean Jordaan's avatar Jean Jordaan

Added note clarifying how `<=` works

parent 71ac370d
...@@ -1088,10 +1088,10 @@ Extending sections (macros) ...@@ -1088,10 +1088,10 @@ Extending sections (macros)
--------------------------- ---------------------------
A section (other than the buildout section) can extend one or more A section (other than the buildout section) can extend one or more
other sections using the ``<=`` option. Options from the referenced other sections using the ``<`` option. Options from the referenced
sections are copied to the referring section *before* variable sections are copied to the referring section *before* variable
substitution. This, together with the ability to refer to variables substitution. This, together with the ability to refer to variables
of the current section, allows sections to be used as macros. of the current section, allows sections to be used as macros::
>>> write(sample_buildout, 'buildout.cfg', >>> write(sample_buildout, 'buildout.cfg',
... """ ... """
...@@ -1134,6 +1134,10 @@ In this example, the ``debug``, ``with_file1`` and ``with_file2`` sections act ...@@ -1134,6 +1134,10 @@ In this example, the ``debug``, ``with_file1`` and ``with_file2`` sections act
as macros. In particular, the variable substitutions are performed as macros. In particular, the variable substitutions are performed
relative to the ``myfiles`` section. relative to the ``myfiles`` section.
.. note:: Don't be fooled by the appearance of the ``<= section`` lines ---
though ``<=`` may look like a new operator, it's still just the familiar
``key = value`` syntax.
Conditional sections Conditional sections
-------------------- --------------------
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment