From d9137a9b888271cdd9e52d5e885fd04589b67578 Mon Sep 17 00:00:00 2001 From: "Karl O. Pinc" Date: Fri, 23 Nov 2018 23:53:40 -0600 Subject: Simply sentences by adding hyperlinks --- docs/narr/startup.rst | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) (limited to 'docs/narr') diff --git a/docs/narr/startup.rst b/docs/narr/startup.rst index f740baadf..6c5fe8f60 100644 --- a/docs/narr/startup.rst +++ b/docs/narr/startup.rst @@ -47,10 +47,14 @@ Here's a high-level time-ordered overview of what happens when you press the :term:`PasteDeploy` library and returns a parser that can understand the format. +.. _ini_section_discovery: + #. The :term:`PasteDeploy` finds a section named either ``[app:main]``, ``[pipeline:main]``, or ``[composite:main]`` in the ``.ini`` file. This section becomes the ``ini`` section for the :term:`WSGI` webserver portion of your application -- the part ``Pyramid`` was built to help with. + .. _entry_point_discovery: + If you're using a simple application (e.g., ``[app:main]``), the application's ``paste.app_factory`` :term:`entry point` will be named on the ``use=`` line within the section's configuration. If instead of a simple @@ -68,8 +72,8 @@ Here's a high-level time-ordered overview of what happens when you press file and uses it to configure the Python standard library logging system for this application. See :ref:`logging_config` for more information. -#. The application's *constructor* is named by the entry point referenced on the ``use=`` line of the ``ini`` section which configures your :app:`Pyramid` application. - It is passed the key/value parameters mentioned within the this section. +#. The application's entry point :ref:`found above `, usually the entry point referenced on the above mentioned ``use=`` line, is the application's *constructor*. + It is passed the key/value parameters in :ref:`the application's .ini section `. The constructor is meant to return a :term:`router` instance, which is a :term:`WSGI` application. For :app:`Pyramid` applications, the constructor will be a function named -- cgit v1.2.3