From 807d5c77801e3d038aa21151235e91496b70fb84 Mon Sep 17 00:00:00 2001 From: "Karl O. Pinc" Date: Sun, 18 Nov 2018 21:13:11 -0600 Subject: Link to startup docs for more detail --- docs/narr/project.rst | 2 ++ docs/narr/startup.rst | 8 +++++++- 2 files changed, 9 insertions(+), 1 deletion(-) (limited to 'docs') diff --git a/docs/narr/project.rst b/docs/narr/project.rst index 89cebd063..3522ea964 100644 --- a/docs/narr/project.rst +++ b/docs/narr/project.rst @@ -871,6 +871,8 @@ 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). + See :ref:`the_startup_process` for more about the application's :ref:`settings ` and ``main``\'s :ref:`arguments ` and statements. + .. index:: single: routes.py diff --git a/docs/narr/startup.rst b/docs/narr/startup.rst index 90792c0ff..be708dfc7 100644 --- a/docs/narr/startup.rst +++ b/docs/narr/startup.rst @@ -18,9 +18,11 @@ on your keyboard after typing ``pserve development.ini`` and the time the lines ``Serving on http://localhost:6543`` are output to your console. .. index:: - single: startup process + single: startup pair: settings; .ini +.. _the_startup_process: + The Startup Process ------------------- @@ -81,6 +83,8 @@ Here's a high-level time-ordered overview of what happens when you press :language: python :linenos: + .. _startup_constructor_arguments: + Note that the constructor function accepts a ``global_config`` argument, which is a dictionary of key/value pairs mentioned in the ``[DEFAULT]`` section of an ``.ini`` file (if :ref:`[DEFAULT] @@ -111,6 +115,8 @@ Here's a high-level time-ordered overview of what happens when you press dictionary captured via the ``**settings`` kwarg as its ``settings`` argument. + .. _startup_settings: + The ``settings`` dictionary contains all the options in the ``[app:main]`` section of our .ini file except the ``use`` option (which is internal to PasteDeploy) such as ``pyramid.reload_templates``, -- cgit v1.2.3