Prep for b1

Merge a bunch of paper-based docs fixes

Configure logging during bfgshell.

4 files changed, 21 insertions, 16 deletions

diff --git a/docs/tutorials/bfgwiki2/authorization.rst b/docs/tutorials/bfgwiki2/authorization.rst
index 7383fe327..9a37760f1 100644
--- a/docs/tutorials/bfgwiki2/authorization.rst
+++ b/docs/tutorials/bfgwiki2/authorization.rst
@@ -105,13 +105,13 @@ Adding ``security.py``
 Add a ``security.py`` module within your package (in the same
 directory as "run.py", "views.py", etc) with the following content:
 The groupfinder defined here is an :term:`authentication policy`
-"callback"; it is a a callable that accepts a userid and a request.
-If the userid exists in the system, the callback will return a
-sequence of group identifiers (or an empty sequence if the user isn't
-a member of any groups).  If the userid *does not* exist in the
-system, the callback will return ``None``.  We'll use "dummy" data to
-represent user and groups sources.  When we're done, your
-application's ``security.py`` will look like this.
+"callback"; it is a callable that accepts a userid and a request.  If
+the userid exists in the system, the callback will return a sequence
+of group identifiers (or an empty sequence if the user isn't a member
+of any groups).  If the userid *does not* exist in the system, the
+callback will return ``None``.  We'll use "dummy" data to represent
+user and groups sources.  When we're done, your application's
+``security.py`` will look like this.
 
 .. literalinclude:: src/authorization/tutorial/security.py
    :linenos:
diff --git a/docs/tutorials/bfgwiki2/basiclayout.rst b/docs/tutorials/bfgwiki2/basiclayout.rst
index 70e7a8a62..4c2d5d238 100644
--- a/docs/tutorials/bfgwiki2/basiclayout.rst
+++ b/docs/tutorials/bfgwiki2/basiclayout.rst
@@ -82,25 +82,25 @@ Here is the source for ``models.py``:
    manager* instead of controlling commits and aborts to database
    operations by hand.
 
-#. *Line 20*. Set up a SQLAlchemy metadata object.
+#. *Line 21*. Set up a SQLAlchemy metadata object.
 
-#. *Lines 22-24*.  A model class named ``Model``.  It has an
+#. *Lines 23-25*.  A model class named ``Model``.  It has an
    ``__init__`` that takes a single argument (``name``).  It stores a
    single attribute named ``name``.
 
-#. *Lines 26-31*.  A SQLAlchemy ``Table`` declaration named
+#. *Lines 27-32*.  A SQLAlchemy ``Table`` declaration named
    ``models_table`` which we'll use later to map onto our ``Model``
    class.
 
-#. *Line 33*.  We map our ``models_table`` table to our Models class
+#. *Line 34*.  We map our ``models_table`` table to our Models class
    here.  This makes an association between the ``Model`` class and
    the ``models`` table in the database, as far as SQLAlchemy is
    concerned.
 
-#. *Lines 35-40*.  A function named ``populate`` which adds a single
+#. *Lines 36-41*.  A function named ``populate`` which adds a single
    model instance into our SQL storage and commits a transaction.
 
-#. *Lines 42-50*.  A function named ``initialize_sql`` which sets up
+#. *Lines 43-51*.  A function named ``initialize_sql`` which sets up
    an actual SQL database and binds it to our SQLAlchemy DBSession
    object.  It also calls the ``populate`` function, to do initial
    database population.
diff --git a/docs/tutorials/bfgwiki2/definingmodels.rst b/docs/tutorials/bfgwiki2/definingmodels.rst
index 214a5e908..d2db4955e 100644
--- a/docs/tutorials/bfgwiki2/definingmodels.rst
+++ b/docs/tutorials/bfgwiki2/definingmodels.rst
@@ -68,6 +68,11 @@ Viewing the Application in a Browser
 ------------------------------------
 
 We can't.  At this point, our system is in a "non-runnable" state;
-we'll need to change the "views" (and associated files) in the next
-chapter to be able to start and run the application successfully.
+we'll need to change view-related files in the next chapter to be able
+to start the application successfully.  If you try to start the
+application, you'll wind up with a Python traceback on your console
+that ends with this exception:
 
+.. code-block:: text
+
+   ImportError: cannot import name Model
diff --git a/docs/tutorials/bfgwiki2/installation.rst b/docs/tutorials/bfgwiki2/installation.rst
index 1a37e1c4d..4c8dc7080 100644
--- a/docs/tutorials/bfgwiki2/installation.rst
+++ b/docs/tutorials/bfgwiki2/installation.rst
@@ -113,7 +113,7 @@ Preparation, Windows
 
    .. code-block:: text
 
-      c:\bigfntut> Scripts/easy_install -i \
+      c:\bigfntut> Scripts\easy_install -i \
                 http://dist.repoze.org/bfg/current/simple repoze.bfg
 
 #. Use ``easy_install`` to install various packages from PyPI.