add caveat for PyPy and Jython users

Chris McDonough

2011-01-21 2323d4898fcc2f524d230025ed6a9f17906023ab

add caveat for PyPy and Jython users

 docs/glossary.rst

@@ -811,9 +811,10 @@
   View handler
     A view handler ties together
     :meth:`pyramid.config.Configurator.add_route` and
     :meth:`pyramid.config.Configurator.add_view` to make it more
     convenient to register a collection of views as a single class when
     using :term:`url dispatch`.  See also :ref:`views_chapter`.
     :meth:`pyramid.config.Configurator.add_view` to make it more convenient
     to register a collection of views as a single class when using
     :term:`url dispatch`.  View handlers ship as part of the
     :term:`pyramid_handlers` add-on package.

   Deployment settings
     Deployment settings are settings passed to the :term:`Configurator` as a
@@ -865,3 +866,19 @@
     `http://docs.pylonsproject.org/projects/pyramid_handlers/dev/
     <http://docs.pylonsproject.org/projects/pyramid_handlers/dev/>`_.

   pyramid_jinja2
     :term:`Jinja2` templating system bindings for Pyramid, documented at
     http://docs.pylonsproject.org/projects/pyramid_jinja2/dev/ .  This
     package also includes a paster template named
     ``pyramid_jinja2_starter``, which creates an application package based
     on the Jinja2 templating system.

   pyramid_sqla
     A package which provides a Pylons-esque paster template which sports
     support for :term:`view handler` application development,
     :term:`SQLAlchemy` support, and other Pylons-like features.  See
     https://bytebucket.org/sluggo/pyramid_sqla/wiki/html/index.html for more
     information.

   


 docs/narr/project.rst

@@ -64,6 +64,16 @@
  URL mapping via :term:`traversal` and persistence via
  :term:`SQLAlchemy`

.. note:: At this time, each of these templates uses the :term:`Chameleon`
   templating system, which is incompatible with both Jython and PyPy.  To
   use paster templates to build applications which will run on Jython and
   PyPy, you can try the ``pyramid_jinja2_starter`` template which ships as
   part of the :term:`pyramid_jinja2` package or the ``pyramid_sqla`` paster
   template which ships with the :term:`pyramid_sqla` package (it uses Mako),
   both available from :term:`PyPI`.  You can also just use the above paster
   templates to build a skeleton and replace the Chameleon template it
   includes with a :term:`Mako` analogue.

.. index::
   single: creating a project
   single: project