summaryrefslogtreecommitdiff
path: root/docs/narr/configuration.rst
AgeCommit message (Collapse)Author
2013-03-22remove unused ignore-next-block directiveTshepang Lekhonkhobe
2013-02-08fix a Sphinx warningTshepang Lekhonkhobe
2013-02-06Merge pull request #849 from tshepang/patch-3Tres Seaver
no need for a 'topic' directive
2013-02-06no need for a 'topic' directiveTshepang Lekhonkhobe
2013-02-06displaying lineno for 1-line snippet is overkillTshepang Lekhonkhobe
2012-01-05Fixed a couple docs bugs reported by davidfung.Michael Merickel
2011-12-16stamp out paste.httpserver usageChris McDonough
2011-07-20typoChris McDonough
2011-07-20use less awkward languageChris McDonough
2011-07-11simplifyChris McDonough
2011-07-11simplifyChris McDonough
2011-01-27module name contractionsChris McDonough
2011-01-19clarifyChris McDonough
2010-12-19wordingChris McDonough
2010-12-16tweakageChris McDonough
2010-12-12fix merge conflictsCasey Duncan
2010-12-09fix docs: pyramid.configuration -> pyramid.configChris McDonough
2010-11-30Merge https://github.com/Pylons/pyramidCasey Duncan
2010-11-28Normalized narrative doc, code with linenos while text+bash don'tBlaise Laflamme
2010-11-19merge changes from masterCasey Duncan
2010-11-19- Remove calls to config.begin()/config.end() from startup config code inChris McDonough
tutorials and paster templates (no longer required).
2010-11-15Add missing closing paren (prose)Casey Duncan
2010-11-15Reword sentence describing what Pyramid config accomplishesCasey Duncan
2010-11-15Reword sentence explaining application configuration for clarityCasey Duncan
2010-11-09- All references to Pyramid-the-application were changed from :mod:`pyramid`Chris McDonough
to :app:`Pyramid`. A custom role setting was added to ``docs/conf.py`` to allow for this. (internal)
2010-11-04simplifyChris McDonough
2010-11-03de-zcml-ify various chapters and move ZCML to the declarative chapterChris McDonough
2010-11-02- Remove references to 'WebOb' Response and just call it 'Response', and noteChris McDonough
that it is imported from pyramid. API docs can mention its inheritance from webob (aka "Provide a webob.Response class facade for forward compat").
2010-10-29bfg_view -> view_configChris McDonough
2010-10-25convert narrative docs to PyramidChris McDonough
2010-04-14Add "exception views" work contributed primarily by Andrey Popp by merging ↵Chris McDonough
the "phash" branch.
2010-01-19Spellcheck.Chris McDonough
2010-01-18Prep for b1Chris McDonough
Merge a bunch of paper-based docs fixes Configure logging during bfgshell.
2010-01-16Massive overhaul to deal with the reality that we don't map URLs directly to ↵Chris McDonough
code.
2010-01-14Merge fixes from paper.Chris McDonough
2010-01-13Merge andrew-docs branch.Chris McDonough
2010-01-11Merge of andrew-docs branch.Chris McDonough
2009-12-31Wording.Chris McDonough
2009-12-31De-stiltify.Chris McDonough
2009-12-30Wording.Chris McDonough
2009-12-27- Added manual index entries to generated index.Chris McDonough
2009-12-27Rendering cleanups.Chris McDonough
2009-12-27Latex rendering.Chris McDonough
Documentation licensing.
2009-12-26- Created new top-level documentation section: "ZCML Directives".Chris McDonough
This section contains detailed ZCML directive information, some of which was removed from various narrative chapters.
2009-12-25Fix syntax errors found via manuel, and add manuel-style markers to preventChris McDonough
untestable code blocks from being tested.
2009-12-25Normalize code blocks.Chris McDonough
2009-12-22Use :meth:, :func:, and :class: appropriately for configuration-related docs.Chris McDonough
2009-12-17FeaturesChris McDonough
-------- - The ``Configurator`` object now has two new methods: ``begin`` and ``end``. The ``begin`` method is meant to be called before any "configuration" begins (e.g. before ``add_view``, et. al are called). The ``end`` method is meant to be called after all "configuration" is complete. Previously, before there was imperative configuration at all (1.1 and prior), configuration begin and end was invariably implied by the process of loading a ZCML file. When a ZCML load happened, the threadlocal data structure containing the request and registry was modified before the load, and torn down after the load, making sure that all framework code that needed ``get_current_registry`` for the duration of the ZCML load was satisfied. Some API methods called during imperative configuration, (such as ``Configurator.add_view`` when a renderer is involved) end up for historical reasons calling ``get_current_registry``. However, in 1.2a5 and below, the Configurator supplied no functionality that allowed people to make sure that ``get_current_registry`` returned the registry implied by the configurator being used. ``begin`` now serves this purpose. Inversely, ``end`` pops the thread local stack, undoing the actions of ``begin``. We make this boundary explicit to reduce the potential for confusion when the configurator is used in different circumstances (e.g. in unit tests and app code vs. just in initial app setup). Existing code written for 1.2a1-1.2a5 which does not call ``begin`` or ``end`` continues to work in the same manner it did before. It is however suggested that this code be changed to call ``begin`` and ``end`` to reduce the potential for confusion in the future. - All ``paster`` templates which generate an application skeleton now make use of the new ``begin`` and ``end`` methods of the Configurator they use in their respective copies of ``run.py`` and ``tests.py``. Documentation ------------- - All documentation that makes use of a ``Configurator`` object to do application setup and test setup now makes use of the new ``begin`` and ``end`` methods of the configurator. Bug Fixes --------- - When a ``repoze.bfg.exceptions.NotFound`` or ``repoze.bfg.exceptions.Forbidden`` *class* (as opposed to instance) was raised as an exception within a root factory (or route root factory), the exception would not be caught properly by the ``repoze.bfg.`` Router and it would propagate to up the call stack, as opposed to rendering the not found view or the forbidden view as would have been expected.
2009-12-09typoFernando Correa Neto
2009-12-09typoFernando Correa Neto