From 5d079ee2149616c5c4861b76255e6b7d71c5ab1b Mon Sep 17 00:00:00 2001
From: Adrian Holovaty <adrian@holovaty.com>
Date: Sun, 25 Mar 2007 21:06:12 +0000
Subject: [PATCH] Added start of 'Creating custom fields' section to
 docs/newforms.txt

git-svn-id: http://code.djangoproject.com/svn/django/trunk@4819 bcc190cf-cafb-0310-a4f2-bffc1f526a37
---
 docs/newforms.txt | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/docs/newforms.txt b/docs/newforms.txt
index d7ef4d2599..ddb850f54c 100644
--- a/docs/newforms.txt
+++ b/docs/newforms.txt
@@ -860,6 +860,16 @@ level and at the form instance level, and the latter gets precedence::
     <tr><th>Url:</th><td><input type="text" name="url" /></td></tr>
     <tr><th>Comment:</th><td><input type="text" name="comment" /></td></tr>
 
+Creating custom fields
+----------------------
+
+If the built-in ``Field`` classes don't meet your needs, you can easily create
+custom ``Field`` classes. To do this, just create a subclass of
+``django.newforms.Field``. Its only requirements are that it implement a
+``clean()`` method and that its ``__init__()`` method accept the core arguments
+mentioned above (``required``, ``label``, ``initial``, ``widget``,
+``help_text``).
+
 More coming soon
 ================