- The ``repoze.bfg.router.make_app`` function is now nominally

  deprecated.  Its import and usage does not throw a warning, nor will
  it probably ever disappear.  However, using a
  ``repoze.bfg.configuration.Configurator`` class is now the preferred
  way to generate a WSGI application.

- The ``run.py`` module in various ``repoze.bfg`` ``paster`` templates
  now use a ``repoze.bfg.configuration.Configurator`` class instead of
  the (now-legacy) ``repoze.bfg.router.make_app`` function to produce
  a WSGI application.

1 files changed, 7 insertions, 4 deletions

diff --git a/docs/narr/project.rst b/docs/narr/project.rst
index 776f6f9a8..80fe6beac 100644
--- a/docs/narr/project.rst
+++ b/docs/narr/project.rst
@@ -692,11 +692,14 @@ without the PasteDeploy configuration file:
 .. literalinclude:: MyProject/myproject/run.py
    :linenos:
 
-#. Line 1 imports the ``make_app`` functions from
-   :mod:`repoze.bfg.router` that we use later.
+#. Line 1 imports the ``Configurator`` class from
+   :mod:`repoze.bfg.configuration` that we use later.
 
-#. Lines 3-10 define a function that returns a :mod:`repoze.bfg` Router
-   application from :ref:`router_module` .  This is meant to be called
+#. Line 2 imports the ``get_root`` function from
+   :mod:`myproject.models` that we use later.
+
+#. Lines 4-11 define a function that returns a :mod:`repoze.bfg`
+   WSGI application.  This function is meant to be called
    by the :term:`PasteDeploy` framework as a result of running
    ``paster serve``.