summaryrefslogtreecommitdiff
path: root/docs/narr/project.rst
diff options
context:
space:
mode:
authorSteve Piercy <web@stevepiercy.com>2018-11-21 14:12:47 -0800
committerSteve Piercy <web@stevepiercy.com>2018-11-21 14:12:47 -0800
commit28f24e7592fc5a7fd28874e9a350f80674583471 (patch)
tree02e402ea6276267ac33884e505ad74a31e70bee9 /docs/narr/project.rst
parent403fd94b39954a1587f2236f8a3ddd2514e8ecb0 (diff)
parent57c9362fb214e926f535961f3a78c54e0cce15ba (diff)
downloadpyramid-28f24e7592fc5a7fd28874e9a350f80674583471.tar.gz
pyramid-28f24e7592fc5a7fd28874e9a350f80674583471.tar.bz2
pyramid-28f24e7592fc5a7fd28874e9a350f80674583471.zip
Merge remote-tracking branch 'upstream/master'
Diffstat (limited to 'docs/narr/project.rst')
-rw-r--r--docs/narr/project.rst20
1 files changed, 11 insertions, 9 deletions
diff --git a/docs/narr/project.rst b/docs/narr/project.rst
index 725263407..14f0d083e 100644
--- a/docs/narr/project.rst
+++ b/docs/narr/project.rst
@@ -139,8 +139,8 @@ or install your application for deployment or development.
An ``.ini`` file named ``development.ini`` will be created in the project
directory. You will use this ``.ini`` file to configure a server, to run your
-application, and to debug your application. It contains configuration that
-enables an interactive debugger and settings optimized for development.
+application, and to debug your application.
+It contains configuration that enables an interactive debugger and :term:`settings` optimized for development.
Another ``.ini`` file named ``production.ini`` will also be created in the
project directory. It contains configuration that disables any interactive
@@ -297,7 +297,7 @@ path to the module on which we want to run tests and coverage.
single: running an application
single: pserve
single: reload
- single: startup
+ single: starting
.. _running_the_project_application:
@@ -658,12 +658,10 @@ only (``127.0.0.1``).
.. _myproject_ini_logging:
The sections after ``# logging configuration`` represent Python's standard
-library :mod:`logging` module configuration for your application. These
-sections are passed to the `logging module's config file configuration engine
-<https://docs.python.org/2/howto/logging.html#configuring-logging>`_ when the
-``pserve`` or ``pshell`` commands are executed. The default configuration
+library :mod:`logging` module configuration for your application.
+The default configuration
sends application logging output to the standard error output of your terminal.
-For more information about logging configuration, see :ref:`logging_chapter`.
+For more information see :ref:`logging_chapter`.
See the :term:`PasteDeploy` documentation for more information about other
types of things you can put into this ``.ini`` file, such as other
@@ -856,7 +854,7 @@ also informs Python that the directory which contains it is a *package*.
WSGI application. This function is meant to be called by the
:term:`PasteDeploy` framework as a result of running ``pserve``.
- Within this function, application configuration is performed.
+ The ``main`` function configures the application.
Line 7 opens a context manager with an instance of a :term:`Configurator`.
@@ -871,6 +869,10 @@ also informs Python that the directory which contains it is a *package*.
Line 11 returns a :term:`WSGI` application to the caller of the function
(Pyramid's pserve).
+.. seealso::
+
+ See :ref:`the_startup_process` for more about the application's :ref:`settings <startup_settings>` and ``main``\'s :ref:`arguments <startup_constructor_arguments>` and statements.
+
.. index::
single: routes.py