Index: topics/forms_api_reference.html
===================================================================
RCS file: /cvs/drupal-contrib/contributions/docs/developer/topics/forms_api_reference.html,v
retrieving revision 1.93
diff -p -u -p -r1.93 forms_api_reference.html
--- topics/forms_api_reference.html	7 Mar 2009 16:25:17 -0000	1.93
+++ topics/forms_api_reference.html	7 Mar 2009 19:01:36 -0000
@@ -56,6 +56,7 @@ td {
       <th scope="col"><a href="#fieldset">fieldset</a></th>
       <th scope="col"><a href="#file">file</a></th>
       <th scope="col"><a href="#password">password</a></th>
+      <th scope="col"><a href="#password-confirm">password confirm</a></th>
       <th scope="col"><a href="#radio">radio</a></th>
       <th scope="col"><a href="#radios">radios</a></th>
       <th scope="col"><a href="#select">select</a></th>
@@ -86,6 +87,7 @@ td {
       <td>-</td>  <!-- fieldset -->
       <td>-</td>  <!-- file -->
       <td class="x"><strong>X</strong></td>  <!-- password -->
+      <td class="x"><strong>X</strong></td>  <!-- password confirm-->
       <td class="x"><strong>X</strong></td>  <!-- radio -->
       <td>-</td>  <!-- radios -->
       <td class="x"><strong>X</strong></td>  <!-- select -->
@@ -101,6 +103,7 @@ td {
       <td class="x"><strong>X</strong></td>  <!-- fieldset -->
       <td class="x"><strong>X</strong></td>  <!-- file -->
       <td class="x"><strong>X</strong></td>  <!-- password -->
+      <td class="x"><strong>X</strong></td>  <!-- password confirm-->
       <td class="x"><strong>X</strong></td>  <!-- radio -->
       <td class="x"><strong>X</strong></td>  <!-- radios -->
       <td class="x"><strong>X</strong></td>  <!-- select -->
@@ -116,6 +119,7 @@ td {
       <td class="x"><strong>X</strong></td>  <!-- fieldset -->
       <td class="x"><strong>X</strong></td>  <!-- file -->
       <td class="x"><strong>X</strong></td>  <!-- password -->
+      <td class="x"><strong>X</strong></td>  <!-- password confirm-->
       <td class="x"><strong>X</strong></td>  <!-- radio -->
       <td class="x"><strong>X</strong></td>  <!-- radios -->
       <td class="x"><strong>X</strong></td>  <!-- select -->
@@ -131,6 +135,7 @@ td {
       <td>-</td>  <!-- fieldset -->
       <td>-</td>  <!-- file -->
       <td>-</td>  <!-- password -->
+      <td>-</td>  <!-- password confirm -->
       <td>-</td>  <!-- radio -->
       <td>-</td>  <!-- radios -->
       <td>-</td>  <!-- select -->
@@ -146,6 +151,7 @@ td {
       <td class="x"><strong>X</strong></td>  <!-- fieldset -->
       <td>-</td>  <!-- file -->
       <td>-</td>  <!-- password -->
+      <td>-</td>  <!-- password confirm -->
       <td>-</td>  <!-- radio -->
       <td>-</td>  <!-- radios -->
       <td>-</td>  <!-- select -->
@@ -161,6 +167,7 @@ td {
       <td class="x"><strong>X</strong></td>  <!-- fieldset -->
       <td>-</td>  <!-- file -->
       <td>-</td>  <!-- password -->
+      <td>-</td>  <!-- password confirm -->
       <td>-</td>  <!-- radio -->
       <td>-</td>  <!-- radios -->
       <td>-</td>  <!-- select -->
@@ -176,6 +183,7 @@ td {
       <td>-</td>  <!-- fieldset -->
       <td>-</td>  <!-- file -->
       <td>-</td>  <!-- password -->
+      <td>-</td>  <!-- password confirm -->
       <td>-</td>  <!-- radio -->
       <td>-</td>  <!-- radios -->
       <td>-</td>  <!-- select -->
@@ -191,6 +199,7 @@ td {
       <td>-</td>  <!-- fieldset -->
       <td>-</td>  <!-- file -->
       <td>-</td>  <!-- password -->
+      <td>-</td>  <!-- password confirm -->
       <td class="x"><strong>X</strong></td>  <!-- radio -->
       <td class="x"><strong>X</strong></td>  <!-- radios -->
       <td class="x"><strong>X</strong></td>  <!-- select -->
@@ -206,6 +215,7 @@ td {
       <td>-</td>  <!-- fieldset -->
       <td>-</td>  <!-- file -->
       <td>-</td>  <!-- password -->
+      <td>-</td>  <!-- password confirm -->
       <td>-</td>  <!-- radio -->
       <td>-</td>  <!-- radios -->
       <td>-</td>  <!-- select -->
@@ -221,6 +231,7 @@ td {
       <td class="x"><strong>X</strong></td>  <!-- fieldset -->
       <td class="x"><strong>X</strong></td>  <!-- file -->
       <td class="x"><strong>X</strong></td>  <!-- password -->
+      <td class="x"><strong>X</strong></td>  <!-- password confirm -->
       <td class="x"><strong>X</strong></td>  <!-- radio -->
       <td class="x"><strong>X</strong></td>  <!-- radios -->
       <td class="x"><strong>X</strong></td>  <!-- select -->
@@ -236,6 +247,7 @@ td {
       <td><strong>-</strong></td>  <!-- fieldset -->
       <td class="x"><strong>X</strong></td>  <!-- file -->
       <td class="x"><strong>X</strong></td>  <!-- password -->
+      <td class="x"><strong>X</strong></td>  <!-- password confirm -->
       <td class="x"><strong>X</strong></td>  <!-- radio -->
       <td class="x"><strong>X</strong></td>  <!-- radios -->
       <td class="x"><strong>X</strong></td>  <!-- select -->
@@ -251,6 +263,7 @@ td {
       <td class="x"><strong>X</strong></td>  <!-- fieldset -->
       <td class="x"><strong>X</strong></td>  <!-- file -->
       <td class="x"><strong>X</strong></td>  <!-- password -->
+      <td class="x"><strong>X</strong></td>  <!-- password confirm -->
       <td class="x"><strong>X</strong></td>  <!-- radio -->
       <td class="x"><strong>X</strong></td>  <!-- radios -->
       <td class="x"><strong>X</strong></td>  <!-- select -->
@@ -266,6 +279,7 @@ td {
       <td>-</td>  <!-- fieldset -->
       <td>-</td>  <!-- file -->
       <td>-</td>  <!-- password -->
+      <td>-</td>  <!-- password confirm -->
       <td>-</td>  <!-- radio -->
       <td>-</td>  <!-- radios -->
       <td>-</td>  <!-- select -->
@@ -281,6 +295,7 @@ td {
       <td>-</td>  <!-- fieldset -->
       <td>-</td>  <!-- file -->
       <td>-</td>  <!-- password -->
+      <td>-</td>  <!-- password confirm -->
       <td>-</td>  <!-- radio -->
       <td>-</td>  <!-- radios -->
       <td>-</td>  <!-- select -->
@@ -296,6 +311,7 @@ td {
       <td>-</td>  <!-- fieldset -->
       <td>-</td>  <!-- file -->
       <td>-</td>  <!-- password -->
+      <td>-</td>  <!-- password confirm -->
       <td>-</td>  <!-- radio -->
       <td>-</td>  <!-- radios -->
       <td>-</td>  <!-- select -->
@@ -311,6 +327,7 @@ td {
       <td>-</td>  <!-- fieldset -->
       <td>-</td>  <!-- file -->
       <td>-</td>  <!-- password -->
+      <td>-</td>  <!-- password confirm -->
       <td>-</td>  <!-- radio -->
       <td>-</td>  <!-- radios -->
       <td>-</td>  <!-- select -->
@@ -326,6 +343,7 @@ td {
       <td>-</td>  <!-- fieldset -->
       <td>-</td>  <!-- file -->
       <td>-</td>  <!-- password -->
+      <td>-</td>  <!-- password confirm -->
       <td>-</td>  <!-- radio -->
       <td>-</td>  <!-- radios -->
       <td class="x"><strong>X</strong></td>  <!-- select -->
@@ -341,6 +359,7 @@ td {
       <td>-</td>  <!-- fieldset -->
       <td>-</td>  <!-- file -->
       <td>-</td>  <!-- password -->
+      <td>-</td>  <!-- password confirm -->
       <td>-</td>  <!-- radio -->
       <td class="x"><strong>X</strong></td>  <!-- radios -->
       <td class="x"><strong>X</strong></td>  <!-- select -->
@@ -356,6 +375,7 @@ td {
       <td class="x"><strong>X</strong></td>  <!-- fieldset -->
       <td class="x"><strong>X</strong></td>  <!-- file -->
       <td class="x"><strong>X</strong></td>  <!-- password -->
+      <td class="x"><strong>X</strong></td>  <!-- password confirm -->
       <td class="x"><strong>X</strong></td>  <!-- radio -->
       <td class="x"><strong>X</strong></td>  <!-- radios -->
       <td class="x"><strong>X</strong></td>  <!-- select -->
@@ -371,6 +391,7 @@ td {
       <td class="x"><strong>X</strong></td>  <!-- fieldset -->
       <td class="x"><strong>X</strong></td>  <!-- file -->
       <td class="x"><strong>X</strong></td>  <!-- password -->
+      <td class="x"><strong>X</strong></td>  <!-- password confirm -->
       <td class="x"><strong>X</strong></td>  <!-- radio -->
       <td class="x"><strong>X</strong></td>  <!-- radios -->
       <td class="x"><strong>X</strong></td>  <!-- select -->
@@ -386,6 +407,7 @@ td {
       <td class="x"><strong>X</strong></td>  <!-- fieldset -->
       <td class="x"><strong>X</strong></td>  <!-- file -->
       <td class="x"><strong>X</strong></td>  <!-- password -->
+      <td class="x"><strong>X</strong></td>  <!-- password confirm -->
       <td class="x"><strong>X</strong></td>  <!-- radio -->
       <td class="x"><strong>X</strong></td>  <!-- radios -->
       <td class="x"><strong>X</strong></td>  <!-- select -->
@@ -401,6 +423,7 @@ td {
       <td class="x"><strong>X</strong></td>  <!-- fieldset -->
       <td class="x"><strong>X</strong></td>  <!-- file -->
       <td class="x"><strong>X</strong></td>  <!-- password -->
+      <td class="x"><strong>X</strong></td>  <!-- password confirm -->
       <td class="x"><strong>X</strong></td>  <!-- radio -->
       <td class="x"><strong>X</strong></td>  <!-- radios -->
       <td class="x"><strong>X</strong></td>  <!-- select -->
@@ -416,6 +439,7 @@ td {
       <td>-</td>  <!-- fieldset -->
       <td>-</td>  <!-- file -->
       <td class="x"><strong>X</strong></td>  <!-- password -->
+      <td class="x"><strong>X</strong></td>  <!-- password confirm -->
       <td class="x"><strong>X</strong></td>  <!-- radio -->
       <td class="x"><strong>X</strong></td>  <!-- radios -->
       <td class="x"><strong>X</strong></td>  <!-- select -->
@@ -431,6 +455,7 @@ td {
       <td>-</td>  <!-- fieldset -->
       <td>-</td>  <!-- file -->
       <td>-</td>  <!-- password -->
+      <td>-</td>  <!-- password confirm -->
       <td class="x"><strong>X</strong></td>  <!-- radio -->
       <td class="x"><strong>X</strong></td>  <!-- radios -->
       <td>-</td>  <!-- select -->
@@ -446,6 +471,7 @@ td {
       <td>-</td>  <!-- fieldset -->
       <td>-</td>  <!-- file -->
       <td>-</td>  <!-- password -->
+      <td>-</td>  <!-- password confirm -->
       <td>-</td>  <!-- radio -->
       <td>-</td>  <!-- radios -->
       <td>-</td>  <!-- select -->
@@ -461,6 +487,7 @@ td {
       <td>-</td>  <!-- fieldset -->
       <td>-</td>  <!-- file -->
       <td>-</td>  <!-- password -->
+      <td>-</td>  <!-- password confirm -->
       <td>-</td>  <!-- radio -->
       <td>-</td>  <!-- radios -->
       <td class="x"><strong>X</strong></td>  <!-- select -->
@@ -476,6 +503,7 @@ td {
       <td class="x"><strong>X</strong></td>  <!-- fieldset -->
       <td class="x"><strong>X</strong></td>  <!-- file -->
       <td class="x"><strong>X</strong></td>  <!-- password -->
+      <td class="x"><strong>X</strong></td>  <!-- password confirm -->
       <td class="x"><strong>X</strong></td>  <!-- radio -->
       <td class="x"><strong>X</strong></td>  <!-- radios -->
       <td class="x"><strong>X</strong></td>  <!-- select -->
@@ -491,6 +519,7 @@ td {
       <td class="x"><strong>X</strong></td>  <!-- fieldset -->
       <td class="x"><strong>X</strong></td>  <!-- file -->
       <td class="x"><strong>X</strong></td>  <!-- password -->
+      <td class="x"><strong>X</strong></td>  <!-- password confirm -->
       <td class="x"><strong>X</strong></td>  <!-- radio -->
       <td class="x"><strong>X</strong></td>  <!-- radios -->
       <td class="x"><strong>X</strong></td>  <!-- select -->
@@ -506,6 +535,7 @@ td {
       <td class="x"><strong>X</strong></td>  <!-- fieldset -->
       <td class="x"><strong>X</strong></td>  <!-- file -->
       <td class="x"><strong>X</strong></td>  <!-- password -->
+      <td class="x"><strong>X</strong></td>  <!-- password confirm -->
       <td class="x"><strong>X</strong></td>  <!-- radio -->
       <td class="x"><strong>X</strong></td>  <!-- radios -->
       <td class="x"><strong>X</strong></td>  <!-- select -->
@@ -521,6 +551,7 @@ td {
       <td class="x"><strong>X</strong></td>  <!-- fieldset -->
       <td class="x"><strong>X</strong></td>  <!-- file -->
       <td class="x"><strong>X</strong></td>  <!-- password -->
+      <td class="x"><strong>X</strong></td>  <!-- password confirm -->
       <td class="x"><strong>X</strong></td>  <!-- radio -->
       <td class="x"><strong>X</strong></td>  <!-- radios -->
       <td class="x"><strong>X</strong></td>  <!-- select -->
@@ -536,6 +567,7 @@ td {
       <td class="x"><strong>X</strong></td>  <!-- fieldset -->
       <td class="x"><strong>X</strong></td>  <!-- file -->
       <td class="x"><strong>X</strong></td>  <!-- password -->
+      <td class="x"><strong>X</strong></td>  <!-- password confirm -->
       <td class="x"><strong>X</strong></td>  <!-- radio -->
       <td class="x"><strong>X</strong></td>  <!-- radios -->
       <td class="x"><strong>X</strong></td>  <!-- select -->
@@ -1116,6 +1148,20 @@ td {
     );<br /></span><span class="b-txt">?&gt;</span></span></code>
   </div>
 
+  <h3><a name="password-confirm" id="password-confirm"></a>password confirm</h3>
+  <p><strong>Description</strong>: Breaks the password field into two separate single-line text boxes that do not display their contents visibly. Used in registration for confirming passwords.</p>
+  <p><strong>Properties</strong>: <a href="#ahah">#ahah</a>, <a href="#attributes">#attributes</a>, <a href="#description">#description</a>, <a href="#maxlength"><strong>#maxlength</strong></a> (default: 30), <a href="#post_render">#post_render</a>, <a href="#prefix">#prefix</a>, <a href="#pre_render">#pre_render</a>, <a href="#required">#required</a>, <a href="#size"><strong>#size</strong></a> (default: 64), <a href="#suffix">#suffix</a>, <a href="#title"><strong>#title</strong></a>, <a href="#type"><strong>#type</strong></a>. <a href="#weightval">#weight</a></p>
+  <p><strong>Usage example</strong> (<a href="http://api.drupal.org/api/file/modules/user/user.module">user.module</a>):</p>
+  <div class="codeblock">
+    <code><span class="def-txt"><span class="b-txt">&lt;?php<br />
+    $form</span><span class="g-txt">[</span><span class="r-txt">'pass'</span><span class="g-txt">] = array(</span><span class="r-txt"><br />
+    &nbsp; '#type'</span> <span class="g-txt">=&gt;</span> <span class="r-txt">'password'</span><span class="g-txt">,</span> <span class="r-txt"><br />
+    &nbsp;&nbsp;'#title'</span> <span class="g-txt">=&gt;</span> <span class="b-txt">t</span><span class="g-txt">(</span><span class="r-txt">'Password'</span><span class="g-txt">),</span> <span class="r-txt"><br />
+    &nbsp;&nbsp;'#maxlength'</span> <span class="g-txt">=&gt;</span> <span class="b-txt">64</span><span class="g-txt">,</span> <span class="r-txt"><br />
+    &nbsp;&nbsp;'#size'</span> <span class="g-txt">=&gt;</span> <span class="b-txt">15</span><span class="g-txt">,<br />
+    );<br /></span><span class="b-txt">?&gt;</span></span></code>
+  </div>
+
   <h3><a name="radio" id="radio"></a>radio</h3>
   <p><strong>Description</strong>: Format a radio button.</p>
   <p><strong>Properties</strong>: <a href="#ahah">#ahah</a>, <a href="#attributes">#attributes</a>, <a href="#default_value"><strong>#default_value</strong></a>, <a href="#description">#description</a>, <a href="#post_render">#post_render</a>, <a href="#prefix">#prefix</a>, <a href="#pre_render">#pre_render</a>, <a href="#required">#required</a>, <a href="#suffix">#suffix</a>, <a href="#title"><strong>#title</strong></a>, <a href="#type"><strong>#type</strong></a>. <a href="#weightval">#weight</a></p>