Index: openacs-4/packages/dotlrn/www/admin/users-bulk-upload.adp
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/dotlrn/www/admin/users-bulk-upload.adp,v
diff -u -r1.6 -r1.7
--- openacs-4/packages/dotlrn/www/admin/users-bulk-upload.adp	9 Aug 2002 18:39:27 -0000	1.6
+++ openacs-4/packages/dotlrn/www/admin/users-bulk-upload.adp	14 Aug 2002 21:24:53 -0000	1.7
@@ -22,26 +22,88 @@
 <property name="title">Users: Bulk Upload</property>
 <property name="context_bar">@context_bar@</property>
 
-This option allows you to bulk upload a number of users from a CSV
-(comma-separated values)
-file. You can create a CSV file using Excel and saving it in the
-correct format.
+Here you can create several users at once using a correctly formatted CSV
+(comma-separated values) file. You can create a spreadsheet and save it as
+a CSV file to import here.
 
 <p>
 
-Your CSV file should have the following header titles:
-<tt>first_names</tt>, <tt>last_name</tt>, <tt>email</tt>. It can also
-include the following optional headers: <tt>id</tt>, <tt>type</tt> (student,
-professor, admin), <tt>access_level</tt> (full, limited),
-<tt>guest</tt> (t for guest, f for non-guest).
+<strong>Be sure</strong> to use vaild email addresses since the process
+will send the new user's password to the given email address.
 
-<p>
+</p>
 
-<b>Note: you will have the option of adding these users to a group
-once they have been uploaded.</b>
-<p>
 
-<FORM enctype=multipart/form-data method=post action=users-bulk-upload-2>
-<INPUT TYPE=file name=users_csv_file><br>
-<INPUT TYPE=submit value=upload>
-</FORM>
+<div style="font-size: large; font-weight: bold;">CSV File Format</div>
+
+<p style="text-indent: 1em">
+  
+  <strong>First Line</strong>
+
+  <p style="text-indent: 2em">
+  
+    The first line of the file <em>must</em> be the header line:
+    
+    <div style="text-indent: 3em; font-family: monospace">
+      first_names,last_name,email,id,type,access_level,guest
+    </div>
+   
+  </p>
+
+</p>
+
+<p style="text-indent: 1em">
+
+  <strong>Fields</strong>
+  
+  <ul>
+    <li><tt>first_names</tt> - <em>required</em>
+    <li><tt>last_name</tt> - <em>required</em>
+    <li><tt>email</tt> - <em>required</em>
+    <li><tt>id</tt> - <em>optional, defaults to email</em> - 
+        a secondary identifier for the  user.
+    <li><tt>type</tt> - <em>required</em> - must be one of 
+      <ul>
+        <li>professor
+        <li>student
+        <li>admin
+        <li>external
+      </ul>
+    <li><tt>access_level</tt> - <em>optional, defaults to full</em> - 
+        <em>must</em> be either <tt>full</tt> or <tt>limited</tt>
+    <li><tt>guest</tt> - <em>optional, defaults to guest</em> -
+        <em>must</em> be either <tt>t</tt> or <tt>f</tt>
+  </ul>
+  
+</p>
+
+<p style="text-indent: 1em">
+
+  <strong>Example File</strong>
+  
+  <pre>
+    first_names,last_name,email,id,type,access_level,guest
+    Joe,Student,joe@_somewhere_.net,123-456-7890,student,full,f
+    Albert,Einstein,al@_school_.edu,al,professor,full,f
+    Systems,Hacker,syshacker@_company_.com,,admin,,,
+    Intersted,Onlooker,onlooker@_somewhere_.net,,external,,limited,t
+  </pre>
+  
+</p>
+
+<p style="text-indent: 1em">
+
+Note: you will have the option of adding these users to a group
+once they have been uploaded.
+
+</p>
+
+<div style="padding-left: 1em">
+
+  <FORM enctype=multipart/form-data method=post action=users-bulk-upload-2>
+  <INPUT TYPE=file name=users_csv_file>
+  <br>
+  <br>
+  <INPUT TYPE=submit value=upload>
+  </FORM>
+</div>