Ticket #9034: template_variable_doc.diff

docs/howto/custom-template-tags.txt

@@ -525 +525 @@
 
 You also have to change the renderer to retrieve the actual contents of the
 ``date_updated`` property of the ``blog_entry`` object.  This can be
-accomplished by using the ``resolve_variable()`` function in
-``django.template``. You pass ``resolve_variable()`` the variable name and the
+accomplished by using the ``Variable`` class in ``django.template``. 
+You pass ``template.Variable`` the variable name and later call the
+returned ``Variable`` instance method ``resolve`` using the
 current context, available in the ``render`` method::
 
     from django import template
-    from django.template import resolve_variable
     import datetime
     class FormatTimeNode(template.Node):
         def __init__(self, date_to_be_formatted, format_string):
-            self.date_to_be_formatted = date_to_be_formatted
+            self.date_to_be_formatted = template.Variable(date_to_be_formatted)
             self.format_string = format_string
 
         def render(self, context):
             try:
-                actual_date = resolve_variable(self.date_to_be_formatted, context)
+                actual_date = self.date_to_be_formatted.resolve(context)
                 return actual_date.strftime(self.format_string)
             except template.VariableDoesNotExist:
                 return ''
 
-``resolve_variable`` will try to resolve ``blog_entry.date_updated`` and then
-format it accordingly.
+The ``Variable`` instance self.date_to_be_formatted method ``resolve``, will
+try to resolve ``blog_entry.date_updated`` and then format it accordingly.
 
 .. versionadded:: 1.0