Missing widget documentation

[Karen Tracey <kmtracey@…>]

In this thread:

​http://groups.google.com/group/django-users/browse_thread/thread/14a89c7f23ae7225

SmileyChris mentions the render_value parameter that can be passed to the PasswordInput widget. Looking at the newforms doc on widgets:

​http://www.djangoproject.com/documentation/newforms/#widgets

I can't see any mention of it, or (from a quick scan of the code) of the format parameter for a DateTimeInput, or of the check_test parameter to a CheckboxInput (not sure if that should be documented or is intended for internal use only?). The widget doc should probably be beefed up to include descriptions of these?

[holdenweb]

Should the widget types perhaps be shown as calls. It's not obvious where this information would go. Though the table of widgets seems like the logical place, this information wouldn't really fit in the existing tabular form. Perhaps I should discuss this on the dev list.

[James Bennett]

I'd say that treating them the way we already treat fields -- common arguments accepted by all widgets, then a list of widgets with notes for each one when it accepts extra arguments as well -- would be the way to do this.

[Karen Tracey]

#7801 asked for doc on render_value specifically.

[Karen Tracey]

#10407 asked for render_value doc also.

[anonymous]

Since the original ticket was opened, widgets are now documented on ​this page.

[Tim Graham]

documentation for render_doc and check_test

[Tim Graham]

forma parameter in DateTimeInput has already been documented

[Tim Graham]

update of patch to apply cleanly to trunk

[Karen Tracey]

(In [11478]) Fixed #6674: Documented a couple of widget arguments. Thanks timo.

[Karen Tracey]

(In [11479]) [1.0.X] Fixed #6674: Documented a couple of widget arguments. Thanks timo.

r11478 from trunk.