From 7c0cf545efbad0c609b9d539c85e532e5c115cd3 Mon Sep 17 00:00:00 2001 From: Luke Plant Date: Fri, 25 Jul 2008 14:47:35 +0000 Subject: [PATCH] Standardised documentation of the Field help_text option and ModelAdmin.fields 'description' option. git-svn-id: http://code.djangoproject.com/svn/django/trunk@8074 bcc190cf-cafb-0310-a4f2-bffc1f526a37 --- docs/admin.txt | 9 +++++++-- docs/model-api.txt | 3 +++ 2 files changed, 10 insertions(+), 2 deletions(-) diff --git a/docs/admin.txt b/docs/admin.txt index 565068e11b5..df96aa944b1 100644 --- a/docs/admin.txt +++ b/docs/admin.txt @@ -139,8 +139,13 @@ The ``field_options`` dictionary can have the following keys: ``description`` A string of optional extra text to be displayed at the top of each fieldset, - under the heading of the fieldset. It's used verbatim, so you can use any HTML - and you must escape any special HTML characters (such as ampersands) yourself. + under the heading of the fieldset. + + Note that this value is *not* HTML-escaped when it's displayed in + the admin interface. This lets you include HTML if you so desire. + Alternatively you can use plain text and + ``django.utils.html.escape()`` to escape any HTML special + characters. ``filter_horizontal`` ~~~~~~~~~~~~~~~~~~~~~ diff --git a/docs/model-api.txt b/docs/model-api.txt index 9a353c0ec41..35731b03fff 100644 --- a/docs/model-api.txt +++ b/docs/model-api.txt @@ -658,6 +658,9 @@ example:: help_text="Please use the following format: YYYY-MM-DD." +Alternatively you can use plain text and +``django.utils.html.escape()`` to escape any HTML special characters. + ``primary_key`` ~~~~~~~~~~~~~~~