From f81d4ba5b3deceeacbe51923f379acb7d033665f Mon Sep 17 00:00:00 2001 From: Ramiro Morales Date: Tue, 25 Jan 2011 15:42:24 +0000 Subject: Fixed #14038 -- Added information to release notes and version changed|added markers to documentation additions for the new template loeaders API introduced in version 1.2. Thanks 3point2 for the report. git-svn-id: http://code.djangoproject.com/svn/django/trunk@15309 bcc190cf-cafb-0310-a4f2-bffc1f526a37 --- docs/ref/settings.txt | 6 ++++++ docs/ref/templates/api.txt | 9 +++++++-- 2 files changed, 13 insertions(+), 2 deletions(-) (limited to 'docs/ref') diff --git a/docs/ref/settings.txt b/docs/ref/settings.txt index 87a71fe6ed..5140d3519d 100644 --- a/docs/ref/settings.txt +++ b/docs/ref/settings.txt @@ -1743,6 +1743,12 @@ used instead of a string. The first item in the tuple should be the ``Loader``'s module, subsequent items are passed to the ``Loader`` during initialization. See :doc:`/ref/templates/api`. +.. versionchanged:: 1.2 + The class-based API for template loaders was introduced in Django 1.2 + although the ``TEMPLATE_LOADERS`` setting will accept strings that specify + function-based loaders until compatibility with them is completely removed in + Django 1.4. + .. setting:: TEMPLATE_STRING_IF_INVALID TEMPLATE_STRING_IF_INVALID diff --git a/docs/ref/templates/api.txt b/docs/ref/templates/api.txt index 0110a63ab6..71fcbd9f56 100644 --- a/docs/ref/templates/api.txt +++ b/docs/ref/templates/api.txt @@ -630,8 +630,13 @@ sources. Some of these other loaders are disabled by default, but you can activate them by editing your :setting:`TEMPLATE_LOADERS` setting. :setting:`TEMPLATE_LOADERS` -should be a tuple of strings, where each string represents a template loader. -Here are the template loaders that come with Django: +should be a tuple of strings, where each string represents a template loader +class. Here are the template loaders that come with Django: + +.. versionchanged:: 1.2 + Template loaders were based on callables (usually functions) before Django + 1.2, starting with the 1.2 release there is a new class-based API, all the + loaders described below implement this new API. ``django.template.loaders.filesystem.Loader`` Loads templates from the filesystem, according to :setting:`TEMPLATE_DIRS`. -- cgit v1.3