summaryrefslogtreecommitdiff
path: root/docs/narr/paste.rst
diff options
context:
space:
mode:
authorChris McDonough <chrism@plope.com>2011-10-06 03:05:29 -0400
committerChris McDonough <chrism@plope.com>2011-10-06 03:05:29 -0400
commitcfb2b5596b8ef366aeef3bce5b61eafc7a2f175d (patch)
treeae20b3579631fff9f4e455fa4929d23420b9a65e /docs/narr/paste.rst
parentd29151abecd85e844b170fb2880dc701b63d7f52 (diff)
downloadpyramid-cfb2b5596b8ef366aeef3bce5b61eafc7a2f175d.tar.gz
pyramid-cfb2b5596b8ef366aeef3bce5b61eafc7a2f175d.tar.bz2
pyramid-cfb2b5596b8ef366aeef3bce5b61eafc7a2f175d.zip
remove all reference to the paster command-line utility
Diffstat (limited to 'docs/narr/paste.rst')
-rw-r--r--docs/narr/paste.rst45
1 files changed, 22 insertions, 23 deletions
diff --git a/docs/narr/paste.rst b/docs/narr/paste.rst
index 39ae4f373..5c7d4c3fb 100644
--- a/docs/narr/paste.rst
+++ b/docs/narr/paste.rst
@@ -1,26 +1,25 @@
.. _paste_chapter:
-Paste
-=====
+PasteDeploy Configuration Files
+===============================
Packages generated via a :term:`scaffold` make use of a system created by Ian
-Bicking named :term:`Paste`. Paste provides the following features:
-
-- A way to declare :term:`WSGI` application configuration in an ``.ini`` file
- (PasteDeploy).
-
-- A :term:`WSGI` server runner (``paster serve``) which can accept
- PasteDeploy ``.ini`` file values as input.
-
-- A mechanism for rendering scaffolds into projects (``paster create``).
-
-Paste is not a particularly integral part of Pyramid. It's more or less used
-directly only in projects created from scaffolds. It's possible to create a
-Pyramid application which does not use Paste at all. We show a Pyramid
-application that doesn't use Paste in :ref:`firstapp_chapter`. However, all
-Pyramid scaffolds use the system, to provide new developers with a
-standardized way of starting, stopping, and setting deployment values. This
-chapter is not a replacement for documentation about Paste or PasteDeploy; it
+Bicking named :term:`PasteDeploy`. PasteDeploy defines a way to declare
+:term:`WSGI` application configuration in an ``.ini`` file.
+
+Pyramid uses this configuration file format in input to its :term:`WSGI`
+server runner ``pserve``, as well as other commands such as ``pviews``,
+``pshell``, ``proutes``, and ``ptweens``.
+
+PasteDeploy is not a particularly integral part of Pyramid. It's possible to
+create a Pyramid application which does not use PasteDeploy at all. We show
+a Pyramid application that doesn't use PasteDeploy in
+:ref:`firstapp_chapter`. However, all Pyramid scaffolds render PasteDeploy
+configuration files, to provide new developers with a standardized way of
+setting deployment values, and to provide new users with a standardized way
+of starting, stopping, and debugging an application.
+
+This chapter is not a replacement for documentation about PasteDeploy; it
only contextualizes the use of Paste within Pyramid. For detailed
documentation, see http://pythonpaste.org.
@@ -29,7 +28,7 @@ PasteDeploy
:term:`PasteDeploy` is the system that Pyramid uses to allow
:term:`deployment settings` to be spelled using an ``.ini`` configuration
-file format. It also allows the ``paster serve`` command to work. Its
+file format. It also allows the ``pserve`` command to work. Its
configuration format provides a convenient place to define application
:term:`deployment settings` and WSGI server settings, and its server runner
allows you to stop and start a Pyramid application easily.
@@ -82,9 +81,9 @@ factory in the ``MyProject`` project which has the entry point named ``main``
where the entry point refers to a ``main`` function in the ``mypackage``
module". Indeed, if you open up the ``__init__.py`` module generated within
any scaffold-generated package, you'll see a ``main`` function. This is the
-function called by :term:`PasteDeploy` when the ``paster serve`` command is
-invoked against our application. It accepts a global configuration object
-and *returns* an instance of our application.
+function called by :term:`PasteDeploy` when the ``pserve`` command is invoked
+against our application. It accepts a global configuration object and
+*returns* an instance of our application.
``[DEFAULTS]`` Section of a PasteDeploy ``.ini`` File
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~