From 546015e6e147130c4f21c87ec9e1537d9f71c3fb Mon Sep 17 00:00:00 2001 From: Mike Bayer Date: Sat, 9 Nov 2013 19:42:01 -0500 Subject: - add a new sphinx extension "viewsource". takes advantage of part of the viewcode extension to allow ad-hoc display of the source of any file, as well as a "directory listing" structure. - reorganize examples/ to take advantage of new extension. in particular, keep moving all the descriptive text for files etc. into module docstrings, taking more advantage of self-documentation. --- examples/elementtree/optimized_al.py | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) (limited to 'examples/elementtree/optimized_al.py') diff --git a/examples/elementtree/optimized_al.py b/examples/elementtree/optimized_al.py index 1dbad0943..e13f5b0ee 100644 --- a/examples/elementtree/optimized_al.py +++ b/examples/elementtree/optimized_al.py @@ -1,7 +1,9 @@ -"""This script duplicates adjacency_list.py, but optimizes the loading -of XML nodes to be based on a "flattened" datamodel. Any number of XML documents, -each of arbitrary complexity, can be loaded in their entirety via a single query -which joins on only three tables. +"""Uses the same strategy as + ``adjacency_list.py``, but associates each DOM row with its owning + document row, so that a full document of DOM nodes can be loaded + using O(1) queries - the construction of the "hierarchy" is performed + after the load in a non-recursive fashion and is more + efficient. """ -- cgit v1.2.1