fix the docs for route_prefix_context to avoid showing up as a doctest

Michael Merickel

2018-10-17 e14661417e7ceb50d5cf83bbd6abd6b133e473ba

 src/pyramid/config/routes.py

@@ -158,8 +158,8 @@
             For backwards compatibility purposes (as of :app:`Pyramid` 1.0), a
             ``path`` keyword argument passed to this function will be used to
             represent the pattern value if the ``pattern`` argument is
             ``None``.  If both ``path`` and ``pattern`` are passed, ``pattern``
             wins.
             ``None``.  If both ``path`` and ``pattern`` are passed,
             ``pattern`` wins.

        xhr

@@ -298,9 +298,9 @@
        if custom_predicates:
            warnings.warn(
                (
                    'The "custom_predicates" argument to Configurator.add_route '
                    'is deprecated as of Pyramid 1.5.  Use '
                    '"config.add_route_predicate" and use the registered '
                    'The "custom_predicates" argument to '
                    'Configurator.add_route is deprecated as of Pyramid 1.5. '
                    'Use "config.add_route_predicate" and use the registered '
                    'route predicate as a predicate argument to add_route '
                    'instead. See "Adding A Third Party View, Route, or '
                    'Subscriber Predicate" in the "Hooks" chapter of the '
@@ -315,9 +315,9 @@
                if '*' in accept:
                    warnings.warn(
                        (
                            'Passing a media range to the "accept" argument of '
                            'Configurator.add_route is deprecated as of Pyramid '
                            '1.10. Use a list of explicit media types.'
                            'Passing a media range to the "accept" argument '
                            'of Configurator.add_route is deprecated as of '
                            'Pyramid 1.10. Use a list of explicit media types.'
                        ),
                        DeprecationWarning,
                        stacklevel=3,
@@ -535,19 +535,18 @@

        Example Usage:

        >>> config = Configurator()
        >>> with config.route_prefix_context('foo'):
        ...     config.add_route('bar', '/bar')
        .. code-block:: python

        Arguments
            config = Configurator()
            with config.route_prefix_context('foo'):
                config.add_route('bar', '/bar')

        route_prefix

          A string suitable to be used as a route prefix, or ``None``.
        ``route_prefix`` is a string suitable to be used as a route prefix,
        or ``None``.

        .. versionadded:: 1.10
        """

        """
        original_route_prefix = self.route_prefix

        if route_prefix is None: