### Eclipse Workspace Patch 1.0
#P Drupal API - DRUPAL-4-7
Index: topics/forms_api_reference.html
===================================================================
RCS file: /cvs/drupal/contributions/docs/developer/topics/forms_api_reference.html,v
retrieving revision 1.31.2.5
diff -u -r1.31.2.5 forms_api_reference.html
--- topics/forms_api_reference.html	11 Jun 2006 14:59:08 -0000	1.31.2.5
+++ topics/forms_api_reference.html	9 Oct 2006 19:31:17 -0000
@@ -23,6 +23,9 @@
 .verified {
   background-color: #CFC;
 }
+.style1 {color: #0000bb}
+.style2 {color: #dd0000}
+.style3 {color: #007700}
 </style>
 </head>
 
@@ -420,6 +423,7 @@
     <th scope="col"><a href="#form">form</a></th>
     <th scope="col"><a href="#hidden">hidden</a></th>
     <th scope="col"><a href="#markup">markup</a></th>
+    <th scope="col"><a href="#item">item</a></th>
     <th scope="col"><a href="#submit">submit</a></th>
     <th scope="col"><a href="#val">value</a></th>
   </tr>
@@ -430,6 +434,7 @@
     <td class="x"><strong>X</strong></td>
     <td class="x"><strong>X</strong></td>
     <td class="x"><strong>X</strong></td>
+    <td class="x"><strong>X</strong></td>
     <td>-</td>
   </tr>
   <tr>
@@ -440,6 +445,7 @@
     <td>-</td>
     <td>-</td>
     <td>-</td>
+    <td>-</td>
   </tr>
   <tr>
     <th scope="row"><a href="#attributes">#attributes</a></th>
@@ -448,6 +454,7 @@
     <td>-</td>
     <td class="x"><strong>X</strong></td>
     <td class="x"><strong>X</strong></td>
+    <td class="x"><strong>X</strong></td>
     <td>-</td>
   </tr>
   <tr>
@@ -458,6 +465,7 @@
     <td>-</td>
     <td>-</td>
     <td>-</td>
+    <td>-</td>
   </tr>
   <tr>
     <th scope="row"><a href="#button_type">#button_type</a></th>
@@ -465,6 +473,7 @@
     <td>-</td>
     <td>-</td>
     <td>-</td>
+    <td>-</td>
     <td class="x"><strong>X</strong></td>
     <td>-</td>
   </tr>
@@ -476,6 +485,7 @@
     <td>-</td>
     <td>-</td>
     <td>-</td>
+    <td>-</td>
   </tr>
   <tr>
     <th scope="row"><a href="#description">#description</a></th>
@@ -483,6 +493,7 @@
     <td>-</td>
     <td>-</td>
     <td class="x"><strong>X</strong></td>
+    <td class="x"><strong>X</strong></td>
     <td>-</td>
     <td>-</td>
   </tr>
@@ -494,6 +505,7 @@
     <td>-</td>
     <td>-</td>
     <td>-</td>
+    <td>-</td>
   </tr>
   <tr class="help">
     <th scope="row"><a href="#parents">#parents</a></th>
@@ -502,6 +514,7 @@
     <td>-</td>
     <td>-</td>
     <td>-</td>
+    <td>-</td>
     <td>-</td>  </tr>
   <tr>
     <th scope="row"><a href="#prefix">#prefix</a></th>
@@ -510,6 +523,7 @@
     <td class="x"><strong>X</strong></td>
     <td class="x"><strong>X</strong></td>
     <td class="x"><strong>X</strong></td>
+    <td class="x"><strong>X</strong></td>
     <td>-</td>
   </tr>
   <tr>
@@ -519,6 +533,7 @@
     <td>-</td>
     <td>-</td>
     <td>-</td>
+    <td>-</td>
     <td>-</td>  </tr>
   <tr>
     <th scope="row"><a href="#required">#required</a></th>
@@ -526,6 +541,7 @@
     <td>-</td>
     <td>-</td>
     <td>-</td>
+    <td class="x"><strong>X</strong></td>
     <td>-</td>
     <td>-</td>
   </tr>
@@ -537,6 +553,7 @@
     <td>-</td>
     <td>-</td>
     <td>-</td>
+    <td>-</td>
   </tr>
   <tr>
     <th scope="row"><a href="#submit_property">#submit</a></th>
@@ -544,6 +561,7 @@
     <td>-</td>
     <td>-</td>
     <td>-</td>
+    <td>-</td>
     <td class="x"><strong>X</strong></td>
     <td>-</td>
   </tr>
@@ -554,6 +572,7 @@
     <td class="x"><strong>X</strong></td>
     <td class="x"><strong>X</strong></td>
     <td class="x"><strong>X</strong></td>
+    <td class="x"><strong>X</strong></td>
     <td>-</td>
   </tr>
   <tr class="help">
@@ -564,12 +583,14 @@
     <td>&nbsp;</td>
     <td>&nbsp;</td>
     <td>&nbsp;</td>
+    <td>&nbsp;</td>
   </tr>
   <tr>
     <th scope="row"><a href="#title"><strong>#title</strong></a></th>
     <td>-</td>
     <td>-</td>
     <td>-</td>
+    <td>-</td>
     <td class="x"><strong>X</strong></td>
     <td>-</td>
     <td>-</td>
@@ -581,6 +602,7 @@
     <td class="x"><strong>X</strong></td>
     <td class="x"><strong>X</strong></td>
     <td class="x"><strong>X</strong></td>
+    <td class="x"><strong>X</strong></td>
     <td>-</td>
   </tr>
   <tr class="help">
@@ -591,6 +613,7 @@
     <td>&nbsp;</td>
     <td>&nbsp;</td>
     <td>&nbsp;</td>
+    <td>&nbsp;</td>
   </tr>
   <tr>
     <th scope="row"><a href="#value">#value</a></th>
@@ -600,6 +623,7 @@
     <td class="x"><strong>X</strong></td>
     <td class="x"><strong>X</strong></td>
     <td class="x"><strong>X</strong></td>
+    <td class="x"><strong>X</strong></td>
   </tr>
   <tr>
     <th scope="row"><a href="#weightval">#weight</a></th>
@@ -608,6 +632,7 @@
     <td>-</td>
     <td class="x"><strong>X</strong></td>
     <td class="x"><strong>X</strong></td>
+    <td class="x"><strong>X</strong></td>
     <td>-</td>
   </tr>
 </table>
@@ -653,6 +678,12 @@
       <li><a href="#suffix">#suffix</a> = '' </li>
     </ul>
   </li>
+  <li><a href="#item"><strong>item</strong></a>
+    <ul>
+      <li><a href="#prefix">#prefix</a> = '' </li>
+      <li><a href="#suffix">#suffix</a> = '' </li>
+    </ul>
+  </li>
   <li><strong><a href="#password">password</a>    </strong>  </li>
   <ul>
     <li><a href="#size">#size</a> = 30</li>
@@ -787,13 +818,27 @@
 <h3><a name="markup" id="markup"></a>markup</h3>
 <p><strong>Description</strong>: Generate generic markup for display inside forms. Note that there is <strong>no need to declare a form element as #type = 'markup'</strong>, as this is the default type. </p>
 <p>Note: if you use markup, if your content is not wrapped in tags (generally &lt;p&gt; or &lt;div&gt;), your content will fall outside of collapsed fieldsets.</p>
-<p><strong>Properties</strong>: <a href="#attributes">#attributes</a>, <a href="#description">#description</a>, <a href="#prefix">#prefix</a> (default: ''), <a href="#suffix">#suffix</a> (default: ''), <a href="#type">#type</a>. <a href="#value"><strong>#value</strong></a>, <a href="#weightval">#weight</a></p>
+<p><strong>Properties</strong>: <a href="#attributes">#attributes</a>, <a href="#prefix">#prefix</a> (default: ''), <a href="#suffix">#suffix</a> (default: ''), <a href="#type">#type</a>, <a href="#value"><strong>#value</strong></a>, <a href="#weightval">#weight</a></p>
 <p><strong>Usage example</strong> (<a href="http://drupaldocs.org/api/head/file/modules/contact.module">contact.module</a>):</p>
 <div class="codeblock"><code><font color="#000000"> <font color="#0000bb">&lt;?php<br />
   $form</font><font color="#007700">[</font><font color="#dd0000">'contact_information'</font><font color="#007700">] = array(</font><font color="#dd0000"><br />
 &nbsp;&nbsp;'#value' </font><font color="#007700">=&gt; </font><font color="#0000bb">variable_get</font><font color="#007700">(</font><font color="#dd0000">'contact_form_information'</font><font color="#007700">, </font><font color="#0000bb">t</font><font color="#007700">(</font><font color="#dd0000">'You can leave us a message using the contact form below.'</font><font color="#007700">)),<br />
 );<br />
 </font><font color="#0000bb">?&gt;</font></font></code></div>
+<h3><a name="item" id="item"></a>item</h3>
+<p><strong>Description</strong>: Generate a display-only form element allowing for an optional title and description. </p>
+<p>Note: since this is a read-only field, setting the <a href="#required">#required</a> property will do nothing except theme the form element to look as if it were actually required (i.e. by placing a red star next to the <a href="#title">#title</a>).</p>
+<p><strong>Properties</strong>: <a href="#attributes">#attributes</a>, <a href="#description">#description</a>, <a href="#prefix">#prefix</a> (default: ''), <a href="#required">#required</a>, <a href="#suffix">#suffix</a> (default: ''), <a href="#title"><strong>#title</strong></a>, <a href="#type"><strong>#type</strong></a>, <a href="#value"><strong>#value</strong></a>, <a href="#weightval">#weight</a></p>
+<p><strong>Usage example</strong> (<a href="http://drupaldocs.org/api/head/file/modules/contact.module">contact.module</a>):</p>
+<div class="codeblock">
+  <p><code><font color="#000000"> <font color="#0000bb">&lt;?php<br />
+  </font></font></code><span class="style1"><code>$form[<span class="style2">'from'</span>] = <span class="style3">array(</span><br />
+&nbsp;&nbsp;</code><code><span class="style2">'#type'</span> =&gt; <span class="style2">'item'</span>,<br />
+&nbsp;     <span class="style2">'#title'</span> =&gt; t(<span class="style2">'From'</span>),<br />
+&nbsp; <span class="style2">'#value'</span> =&gt; $user-&gt;name .<span class="style2">' &amp;lt;'</span>. $user-&gt;mail .<span class="style2">'&amp;gt;'</span>,<br />
+<span class="style3">);</span></code></span><code><font color="#000000"><font color="#007700"><br />
+    </font><font color="#0000bb">?&gt;</font></font></code></p>
+  </div>
 <h3><a name="password" id="password"></a>password</h3>
 <p><strong>Description</strong>:
 Format a single-line text field that does not display its contents visibly.</p>
