Doc tweaks.

1 files changed, 5 insertions, 5 deletions

diff --git a/repoze/bfg/router.py b/repoze/bfg/router.py
index 9dd590fc0..791d6772e 100644
--- a/repoze/bfg/router.py
+++ b/repoze/bfg/router.py
@@ -54,12 +54,12 @@ class Router:
 
 def make_app(root_policy, package=None, filename='configure.zcml'):
     """ Create a view registry based on the application's ZCML.  and
-    return a Router object, representing a repoze.bfg WSGI
-    application.  'root_policy' must be a callable that accepts an
-    environ and returns a graph root object.  'package' is the
+    return a Router object, representing a ``repoze.bfg`` WSGI
+    application.  'root_policy' must be a callable that accepts a WSGI
+    environment and returns a graph root object.  'package' is the
     dotted-Python-path packagename of the application, 'filename' is
-    the ZCML file (relative to the package path) that should be parsed
-    to create the view registry."""
+    the filesystem path to a ZCML file (optionally relative to the
+    package path) that should be parsed to create the view registry."""
     from repoze.bfg.registry import makeRegistry
     registry = makeRegistry(filename, package)
     return Router(root_policy, registry)