- 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.

1 files changed, 4 insertions, 3 deletions

diff --git a/examples/generic_associations/table_per_association.py b/examples/generic_associations/table_per_association.py
index 4cdc35494..4993492a4 100644
--- a/examples/generic_associations/table_per_association.py
+++ b/examples/generic_associations/table_per_association.py
@@ -1,8 +1,9 @@
 """table_per_association.py
 
-The HasAddresses mixin will provide a new "address_association" table for
-each parent class.   The "address" table will be shared
-for all parents.
+Illustrates a mixin which provides a generic association
+via a individually generated association tables for each parent class.
+The associated objects themselves are persisted in a single table
+shared among all parents.
 
 This configuration has the advantage that all Address
 rows are in one table, so that the definition of "Address"