Index: docs/model-api.txt
===================================================================
--- docs/model-api.txt	(revision 3129)
+++ docs/model-api.txt	(working copy)
@@ -322,6 +322,14 @@
 
 The admin represents this as a ``<select>`` box with "Unknown", "Yes" and "No" choices.
 
+``PasswordField``
+~~~~~~~~~~~~~~~~~  
+
+A ``PasswordField`` is like a ``TextField`` but the difference is that the
+characters that are entered are masked, typically by asterisks (*). Also note
+that even though this is a password field the data is sent as clear text to
+the server. Additional measures are needed to ensure data safety.
+
 ``PhoneNumberField``
 ~~~~~~~~~~~~~~~~~~~~