Source

options / README.rst

Diff from to

File README.rst

 A module that helps encapsulate option and configuration data using a
-multi-layer stacking model.
+multi-layer stacking (a.k.a. nested context) model.
 
 Classes, for example, set default values for all
 instances. Instances can set new values. If an instance doesn't set a value, the
 
 Python's ``*args`` variable-number of arguments and ``**kwargs`` keyword
 arguments are sometimes called "magic" arguments. ``options`` takes this up
-a notch, allowing arguments to be interpreted on the fly. This is useful, for instance,
+a notch, allowing setters much like Python's ``property`` function or ``@property``
+decorator, in turn allowing arguments to be interpreted on the fly. This is useful, for instance,
 to provide relative rather than just absolute values. As an example, say that
 we added this code after
 ``Shape.options``