From 25fc86e99528289f0252a0b8fc0f7f5d7ed2bd04 Mon Sep 17 00:00:00 2001
From: Steve Piercy <web@stevepiercy.com>
Date: Fri, 01 Dec 2017 19:48:18 +0100
Subject: [PATCH] Clarify when and how waitress is installed. - see #3204

---
 docs/quick_tutorial/ini.rst |    6 ++++--
 1 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/docs/quick_tutorial/ini.rst b/docs/quick_tutorial/ini.rst
index f6d64ee..e4f3040 100644
--- a/docs/quick_tutorial/ini.rst
+++ b/docs/quick_tutorial/ini.rst
@@ -101,11 +101,13 @@
 
 - *Configuring the WSGI server*. ``[server:main]`` wires up the choice
   of which WSGI *server* for your WSGI *application*. In this case, we
-  are using ``waitress`` which was specified in
-  ``tutorial/setup.py``. It also wires up the *port number*:
+  are using ``waitress`` which we specified in
+  ``tutorial/setup.py`` and was installed in the :doc:`requirements` step at the start of this tutorial.  It also wires up the *port number*:
   ``listen = localhost:6543`` tells ``waitress`` to listen on host
   ``localhost`` at port ``6543``.
 
+  .. note:: Running the command ``$VENV/bin/pip install -e .`` will check for previously installed packages in our virtual environment that are specified in our package's ``setup.py`` file, then install our package in editable mode, installing any requirements that were not previously installed.  If a requirement was manually installed previously on the command line or otherwise, in this case Waitress, then ``$VENV/bin/pip install -e .`` will merely check that it is installed and move on.
+
 - *Configuring Python logging*. Pyramid uses Python standard logging, which
   needs a number of configuration values. The ``.ini`` serves this function.
   This provides the console log output that you see on startup and each

--
Gitblit v1.9.3