Index: openacs-4/packages/categories/tcl/widget-procs.tcl
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/categories/tcl/widget-procs.tcl,v
diff -u -r1.20 -r1.21
--- openacs-4/packages/categories/tcl/widget-procs.tcl	28 Aug 2007 16:30:03 -0000	1.20
+++ openacs-4/packages/categories/tcl/widget-procs.tcl	7 Oct 2007 22:36:56 -0000	1.21
@@ -14,9 +14,24 @@
 namespace eval template::data::transform {}
 namespace eval template::data::validate {}
 
-ad_proc -public template::widget::category { element_reference tag_attributes } {
-    # author: Timo Hentschel (timo@timohentschel.de)
-
+ad_proc -public template::widget::category { 
+    element_reference 
+    tag_attributes 
+} {
+    Display the category widget. This has a multitude of options:
+    <ul>
+    <li>value: Values should be a list of two items: the object_id being viewed and the object_id which the trees are mapped to. 
+    This will get the mapped trees (if no value provided defaults to package_id) and the mapped categories for the object_id. If you
+    do not provide a value, the following options are used:
+    <li>category_application_id></li>
+    <li>category_object_id</li>
+    <li>category_tree_id</li>
+    <li>category_subtree_id</li>
+    <li>category_assign_single_p</li>
+    <li>category_require_category_p</li>
+    </ul>
+    @author: Timo Hentschel (timo@timohentschel.de)
+} {
     upvar $element_reference element
 
     if { [info exists element(html)] } {