From 798a398c855bc480807cbaa96a4675dc2d9269f3 Mon Sep 17 00:00:00 2001 From: Casey Duncan Date: Wed, 15 Dec 2010 00:15:44 -0700 Subject: add missing last sentence --- docs/narr/models.rst | 8 ++++++++ 1 file changed, 8 insertions(+) (limited to 'docs') diff --git a/docs/narr/models.rst b/docs/narr/models.rst index c726ae9b4..79286590a 100644 --- a/docs/narr/models.rst +++ b/docs/narr/models.rst @@ -266,6 +266,14 @@ subobjects should have a ``__name__`` attribute that matches the name by which they are retrieved from the container via ``__getitem__``. This pattern continues recursively down the graph. +The ``__parent__`` attributes of each node form a linked list +that points "upward" toward the root. This is analogous to the +`..` entry in filesystem directories. If you follow the ``__parent__`` +values from any node in the traversal graph, you will eventually +come to the root node, just like if you keep executing the +``cd ..`` filesystem command, eventually you will reach the +filesystem root directory. + .. warning:: If your root model object has a ``__name__`` argument that is not ``None`` or the empty string, URLs returned by the :func:`pyramid.url.model_url` function and paths generated by -- cgit v1.2.3