From 178109c1734ccc16386c3e3cbae1465c7a1b8ed8 Mon Sep 17 00:00:00 2001 From: Mariusz Felisiak Date: Mon, 10 Jan 2022 12:16:15 +0100 Subject: [PATCH] Corrected signatures of some functions in docs. --- docs/ref/templates/api.txt | 10 +++++----- docs/topics/cache.txt | 2 +- docs/topics/i18n/translation.txt | 2 +- docs/topics/testing/tools.txt | 4 ++-- 4 files changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/ref/templates/api.txt b/docs/ref/templates/api.txt index 7e9812fffb..1082823e71 100644 --- a/docs/ref/templates/api.txt +++ b/docs/ref/templates/api.txt @@ -654,7 +654,7 @@ Here's what each of the built-in processors does: ``django.contrib.auth.context_processors.auth`` ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. function:: auth +.. function:: auth(request) If this processor is enabled, every ``RequestContext`` will contain these variables: @@ -672,7 +672,7 @@ variables: ``django.template.context_processors.debug`` ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. function:: debug +.. function:: debug(request) If this processor is enabled, every ``RequestContext`` will contain these two variables -- but only if your :setting:`DEBUG` setting is set to ``True`` and @@ -689,7 +689,7 @@ the request's IP address (``request.META['REMOTE_ADDR']``) is in the ``django.template.context_processors.i18n`` ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. function:: i18n +.. function:: i18n(request) If this processor is enabled, every ``RequestContext`` will contain these variables: @@ -713,7 +713,7 @@ If this processor is enabled, every ``RequestContext`` will contain a variable ``django.template.context_processors.static`` ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. function:: static +.. function:: static(request) If this processor is enabled, every ``RequestContext`` will contain a variable ``STATIC_URL``, providing the value of the :setting:`STATIC_URL` setting. @@ -734,7 +734,7 @@ If this processor is enabled, every ``RequestContext`` will contain a variable ``django.template.context_processors.tz`` ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. function:: tz +.. function:: tz(request) If this processor is enabled, every ``RequestContext`` will contain a variable ``TIME_ZONE``, providing the name of the currently active time zone. diff --git a/docs/topics/cache.txt b/docs/topics/cache.txt index e9c3a025c8..f405e171d5 100644 --- a/docs/topics/cache.txt +++ b/docs/topics/cache.txt @@ -647,7 +647,7 @@ __ `Controlling cache: Using other headers`_ The per-view cache ================== -.. function:: django.views.decorators.cache.cache_page +.. function:: django.views.decorators.cache.cache_page(timeout, *, cache=None, key_prefix=None) A more granular way to use the caching framework is by caching the output of individual views. ``django.views.decorators.cache`` defines a ``cache_page`` diff --git a/docs/topics/i18n/translation.txt b/docs/topics/i18n/translation.txt index 99fc41ebb6..bc10ce73cf 100644 --- a/docs/topics/i18n/translation.txt +++ b/docs/topics/i18n/translation.txt @@ -515,7 +515,7 @@ And then later:: Localized names of languages ---------------------------- -.. function:: get_language_info +.. function:: get_language_info(lang_code) The ``get_language_info()`` function provides detailed information about languages:: diff --git a/docs/topics/testing/tools.txt b/docs/topics/testing/tools.txt index 92dcd92bf4..1d8cbfbd72 100644 --- a/docs/topics/testing/tools.txt +++ b/docs/topics/testing/tools.txt @@ -1290,7 +1290,7 @@ For each action, you can supply either a list of values or a string. When the value already exists in the list, ``append`` and ``prepend`` have no effect; neither does ``remove`` when the value doesn't exist. -.. function:: override_settings +.. function:: override_settings(**kwargs) In case you want to override a setting for a test method, Django provides the :func:`~django.test.override_settings` decorator (see :pep:`318`). It's used @@ -1316,7 +1316,7 @@ The decorator can also be applied to :class:`~django.test.TestCase` classes:: response = self.client.get('/sekrit/') self.assertRedirects(response, '/other/login/?next=/sekrit/') -.. function:: modify_settings +.. function:: modify_settings(*args, **kwargs) Likewise, Django provides the :func:`~django.test.modify_settings` decorator::