[Checkins] SVN: megrok.trails/trunk/src/megrok/trails/ Cleaned up a few rough edges in the megrok.trails code.

[Brandon Rhodes]

Log message for revision 87745:
  Cleaned up a few rough edges in the megrok.trails code.
  

Changed:
  U   megrok.trails/trunk/src/megrok/trails/__init__.py
  U   megrok.trails/trunk/src/megrok/trails/components.py
  U   megrok.trails/trunk/src/megrok/trails/ftests/__init__.py
  U   megrok.trails/trunk/src/megrok/trails/ftests/traversal/__init__.py
  U   megrok.trails/trunk/src/megrok/trails/ftests/traversal/traversal.py
  U   megrok.trails/trunk/src/megrok/trails/ftests/url/__init__.py
  U   megrok.trails/trunk/src/megrok/trails/ftests/url/url.py

-=-
Modified: megrok.trails/trunk/src/megrok/trails/__init__.py
===================================================================
--- megrok.trails/trunk/src/megrok/trails/__init__.py	2008-06-25 04:51:00 UTC (rev 87744)
+++ megrok.trails/trunk/src/megrok/trails/__init__.py	2008-06-25 04:53:23 UTC (rev 87745)
@@ -1,6 +1,6 @@
 ##############################################################################
 #
-# Copyright (c) 2007 Zope Corporation and Contributors.
+# Copyright (c) 2007-2008 Zope Corporation and Contributors.
 # All Rights Reserved.
 #
 # This software is subject to the provisions of the Zope Public License,
@@ -12,4 +12,11 @@
 #
 ##############################################################################
 
+"""megrok.trails - automatic URL traversal for Grok
+
+The TrailHead and Trail components provided in this module allow a
+developer to write recipes, called 'trails', for the kinds of URLs which
+he wants his web application to accept.  See README.txt for more details.
+
+"""
 from megrok.trails.components import TrailHead, Trail

Modified: megrok.trails/trunk/src/megrok/trails/components.py
===================================================================
--- megrok.trails/trunk/src/megrok/trails/components.py	2008-06-25 04:51:00 UTC (rev 87744)
+++ megrok.trails/trunk/src/megrok/trails/components.py	2008-06-25 04:53:23 UTC (rev 87745)
@@ -1,6 +1,6 @@
 ##############################################################################
 #
-# Copyright (c) 2007 Zope Corporation and Contributors.
+# Copyright (c) 2007-2008 Zope Corporation and Contributors.
 # All Rights Reserved.
 #
 # This software is subject to the provisions of the Zope Public License,

Modified: megrok.trails/trunk/src/megrok/trails/ftests/__init__.py
===================================================================
--- megrok.trails/trunk/src/megrok/trails/ftests/__init__.py	2008-06-25 04:51:00 UTC (rev 87744)
+++ megrok.trails/trunk/src/megrok/trails/ftests/__init__.py	2008-06-25 04:53:23 UTC (rev 87745)
@@ -1,2 +1 @@
-# this is a package
-
+"""Functional tests for megrok.trails."""

Modified: megrok.trails/trunk/src/megrok/trails/ftests/traversal/__init__.py
===================================================================
--- megrok.trails/trunk/src/megrok/trails/ftests/traversal/__init__.py	2008-06-25 04:51:00 UTC (rev 87744)
+++ megrok.trails/trunk/src/megrok/trails/ftests/traversal/__init__.py	2008-06-25 04:53:23 UTC (rev 87745)
@@ -1 +1 @@
-# this is a package
+"""Traversal functional tests for megrok.trails."""

Modified: megrok.trails/trunk/src/megrok/trails/ftests/traversal/traversal.py
===================================================================
--- megrok.trails/trunk/src/megrok/trails/ftests/traversal/traversal.py	2008-06-25 04:51:00 UTC (rev 87744)
+++ megrok.trails/trunk/src/megrok/trails/ftests/traversal/traversal.py	2008-06-25 04:53:23 UTC (rev 87745)
@@ -1,6 +1,6 @@
 ##############################################################################
 #
-# Copyright (c) 2007 Zope Corporation and Contributors.
+# Copyright (c) 2007-2008 Zope Corporation and Contributors.
 # All Rights Reserved.
 #
 # This software is subject to the provisions of the Zope Public License,
@@ -60,8 +60,3 @@
     trails = [
         Trail('/mammoth/:name', Mammoth),
         ]
-    #def __init__(self, *args):
-    #    self.trails = [
-    #        Trail('/mammoth/:name', Mammoth),
-    #        ]
-    #    TrailHead.__init__(self, *args)

Modified: megrok.trails/trunk/src/megrok/trails/ftests/url/__init__.py
===================================================================
--- megrok.trails/trunk/src/megrok/trails/ftests/url/__init__.py	2008-06-25 04:51:00 UTC (rev 87744)
+++ megrok.trails/trunk/src/megrok/trails/ftests/url/__init__.py	2008-06-25 04:53:23 UTC (rev 87745)
@@ -1 +1 @@
-# this is a package
+"""URL functional tests for megrok.trails."""

Modified: megrok.trails/trunk/src/megrok/trails/ftests/url/url.py
===================================================================
--- megrok.trails/trunk/src/megrok/trails/ftests/url/url.py	2008-06-25 04:51:00 UTC (rev 87744)
+++ megrok.trails/trunk/src/megrok/trails/ftests/url/url.py	2008-06-25 04:53:23 UTC (rev 87745)
@@ -1,6 +1,6 @@
 ##############################################################################
 #
-# Copyright (c) 2007 Zope Corporation and Contributors.
+# Copyright (c) 2007-2008 Zope Corporation and Contributors.
 # All Rights Reserved.
 #
 # This software is subject to the provisions of the Zope Public License,
@@ -20,8 +20,9 @@
   >>> from zope.app.component.hooks import setSite
   >>> setSite(app)
 
-This should not be necessary, but at the moment is, possibly because
-the test suite groks things different than a production instance:
+The line that follows should not be necessary, but at the moment is,
+possibly because the test suite groks things different than a production
+instance:
 
   >>> Trail('/mammoth/:name', IMammoth) and None
 
@@ -68,5 +69,4 @@
     grok.context(App)
     grok.name('index')
     def render(self):
-        print>>open('/tmp/foof','w'), 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', type(self.request)
         return 'The URL of the mammoth is %s.' % self.url(Mammoth('Knuth'))