diff --git a/doc/modeling.rst b/doc/modeling.rst index 0582bc9c..33b2aeb7 100644 --- a/doc/modeling.rst +++ b/doc/modeling.rst @@ -170,10 +170,10 @@ attribute except for the top-level class whose name is "main" if left undefined. collection of dummy model elements, with their attributes set as follows. When a defaults class is defined within another defaults class, the child automatically inherits all attribute values from the parent. It can then override some or all of them by defining the corresponding attributes. The top-level defaults class does not have a parent, and -so its attributes are initialized to internal defaults which are shown in the reference documentation below. +so its attributes are initialized to internal defaults which are shown in the :doc:`Reference chapter`. The dummy elements contained in the defaults classes are not part of the model; they are only used to initialize the -attribute values of the actual model elements. When an actual element if first created, all its attributes are copied +attribute values of the actual model elements. When an actual element is first created, all its attributes are copied from the corresponding dummy element in the defaults class that is currently active. There is always an active defaults class, which can be determined in one of three ways. If no class is specified in the present element or any of its ancestor bodies, the top-level class is used (regardless of whether it is called "main" or something else). If