[1.6.x] Fixed #21306 -- Documented lower-casing behavior of title filter.

Backport of eafe279120 from master

1 files changed, 4 insertions, 3 deletions

diff --git a/docs/ref/templates/builtins.txt b/docs/ref/templates/builtins.txt
index e92a46e163..c579cb489a 100644
--- a/docs/ref/templates/builtins.txt
+++ b/docs/ref/templates/builtins.txt
@@ -2091,14 +2091,15 @@ date that is in the past relative to the comparison point.
 title
 ^^^^^
 
-Converts a string into titlecase by capitalizing each word in the string.
-This tag makes no effort to keep "trivial words" in lowercase.
+Converts a string into titlecase by making words start with an uppercase
+character and the remaining characters lowercase. This tag makes no effort to
+keep "trivial words" in lowercase.
 
 For example::
 
     {{ value|title }}
 
-If ``value`` is ``"my first post"``, the output will be ``"My First Post"``.
+If ``value`` is ``"my FIRST post"``, the output will be ``"My First Post"``.
 
 .. templatefilter:: truncatechars