=== modified file 'src/docbkx/en/dhis2_user_man_web_api.xml'
--- src/docbkx/en/dhis2_user_man_web_api.xml	2014-07-25 09:02:14 +0000
+++ src/docbkx/en/dhis2_user_man_web_api.xml	2014-08-14 22:54:45 +0000
@@ -1463,6 +1463,10 @@
     <para>To retrieve the form filled with data values for a specific period and organisation unit
       in XML:</para>
     <screen>api/dataSets/BfMAe6Itzgt/form.xml?ou=DiszpKrYNg8&amp;pe=201401</screen>
+    <para>When it comes to custom data entry forms, this resource also allows for creating such
+      forms directly for a data set. This can be done through a POST or PUT request with content
+      type text/html where the payload is the custom form markup such as:</para>
+    <screen>curl -d @form.html "localhost/api/dataSets/BfMAe6Itzgt/form" -H "Content-Type:text/html" -u admin:district -X PUT -v</screen>
   </section>
   <section>
     <title>Reading complete data set registrations</title>