summaryrefslogtreecommitdiff
path: root/docs/narr
diff options
context:
space:
mode:
authorBen Bangert <ben@groovie.org>2010-10-29 16:03:20 -0700
committerBen Bangert <ben@groovie.org>2010-10-29 16:03:20 -0700
commit8b0d7ce11cb836b9073010d524cb7f636f1649ec (patch)
treee8f0309546ebb8c40ee83a5416f60e4f12ccfb65 /docs/narr
parent17e70c8db9140c0b4062f46ef5eb4527d678b793 (diff)
parent71ff1038f9ae7578e303ca9f657d34e4ee09305a (diff)
downloadpyramid-8b0d7ce11cb836b9073010d524cb7f636f1649ec.tar.gz
pyramid-8b0d7ce11cb836b9073010d524cb7f636f1649ec.tar.bz2
pyramid-8b0d7ce11cb836b9073010d524cb7f636f1649ec.zip
Merge branch 'master' of github.com:Pylons/pyramid
Diffstat (limited to 'docs/narr')
-rw-r--r--docs/narr/project.rst40
-rw-r--r--docs/narr/views.rst2
2 files changed, 21 insertions, 21 deletions
diff --git a/docs/narr/project.rst b/docs/narr/project.rst
index f88496fcc..4e140709c 100644
--- a/docs/narr/project.rst
+++ b/docs/narr/project.rst
@@ -117,7 +117,7 @@ project we name ``MyProject``:
$ bin/paster create -t pyramid_starter
Selected and implied templates:
- pyramid#bfg pyramid starter project
+ pyramid#pyramid_starter pyramid starter project
Enter project name: MyProject
Variables:
@@ -223,18 +223,18 @@ the ``pyramid_starter`` template, a single sample test exists.
.. index::
single: interactive shell
single: IPython
- single: paster bfgshell
+ single: paster pshell
The Interactive Shell
---------------------
Once you've installed your program for development using ``setup.py
develop``, you can use an interactive Python shell to examine your
-:mod:`pyramid` application :term:`model` and :term:`view` objects
-from a Python prompt. To do so, use the ``paster`` shell command with
-the ``bfgshell`` argument:
+:mod:`pyramid` application :term:`model` and :term:`view` objects from
+a Python prompt. To do so, use the ``paster`` shell command with the
+``pshell`` argument:
-The first argument to ``bfgshell`` is the path to your application's
+The first argument to ``pshell`` is the path to your application's
``.ini`` file. The second is the section name inside the ``.ini``
file which points to your *application* as opposed to any other
section within the ``.ini`` file. For example, if your application
@@ -256,37 +256,37 @@ the name ``main`` as a section name:
.. code-block:: text
- [chrism@vitaminf bfgshellenv]$ ../bin/paster --plugin=pyramid bfgshell \
- MyProject.ini main
+ [chrism@vitaminf shellenv]$ ../bin/paster --plugin=pyramid \
+ pshell MyProject.ini main
Python 2.4.5 (#1, Aug 29 2008, 12:27:37)
[GCC 4.0.1 (Apple Inc. build 5465)] on darwin
- Type "help" for more information. "root" is the BFG app root object.
+ Type "help" for more information. "root" is the Pyramid app root object.
>>> root
<foo.models.MyModel object at 0x445270>
.. note:: You *might* get away without passing
- ``--plugin=pyramid`` to the bfgshell command.
+ ``--plugin=pyramid`` to the ``pshell`` command.
If you have `IPython <http://en.wikipedia.org/wiki/IPython>`_
installed in the interpreter you use to invoke the ``paster`` command,
-the ``bfgshell`` command will use an IPython interactive shell instead
+the ``pshell`` command will use an IPython interactive shell instead
of a standard Python interpreter shell. If you don't want this to
happen, even if you have IPython installed, you can pass the
-``--disable-ipython`` flag to the ``bfgshell`` command to use a
-standard Python interpreter shell unconditionally.
+``--disable-ipython`` flag to the ``pshell`` command to use a standard
+Python interpreter shell unconditionally.
.. code-block:: text
- [chrism@vitaminf bfgshellenv]$ ../bin/paster --plugin=pyramid bfgshell \
+ [chrism@vitaminf shellenv]$ ../bin/paster --plugin=pyramid pshell \
--disable-ipython MyProject.ini main
You should always use a section name argument that refers to the
actual ``app`` section within the Paste configuration file that points
-at your :mod:`pyramid` application *without any middleware
-wrapping*. In particular, a section name is inappropriate as the
-second argument to "bfgshell" if the configuration section it names is
-a ``pipeline`` rather than an ``app``. For example, if you have the
-following ``.ini`` file content:
+at your :mod:`pyramid` application *without any middleware wrapping*.
+In particular, a section name is inappropriate as the second argument
+to ``pshell`` if the configuration section it names is a ``pipeline``
+rather than an ``app``. For example, if you have the following
+``.ini`` file content:
.. code-block:: ini
:linenos:
@@ -307,7 +307,7 @@ The command you use to invoke the interactive shell should be:
.. code-block:: text
- [chrism@vitaminf bfgshellenv]$ ../bin/paster --plugin=pyramid bfgshell \
+ [chrism@vitaminf shellenv]$ ../bin/paster --plugin=pyramid pshell \
MyProject.ini myapp
If you use ``main`` as the section name argument instead of ``myapp``
diff --git a/docs/narr/views.rst b/docs/narr/views.rst
index 39115a493..37fb6562b 100644
--- a/docs/narr/views.rst
+++ b/docs/narr/views.rst
@@ -1502,7 +1502,7 @@ See :ref:`view_directive` for complete ZCML directive documentation.
.. _mapping_views_using_a_decorator_section:
View Configuration Using the ``@view_config`` Decorator
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
For better locality of reference, you may use the
:class:`pyramid.view.view_config` decorator to associate your view