Detailed instructions and documentation can be found at: http://www.itc.virginia.edu/desktop/web/efdoc.html Brief overview of easyform.cgi and easymail.cgi Description of files. These are the only files installed or created by the easyform package. easyform.cgi - a perl script to take HTML form data and put it in a file easymail.cgi - a perl script to take HTML form data and email it output.txt - the data from your HTML form formkeys.dat - the field names (column names) from your HTML form email.dat - used only when mailing form data; Who gets the email. Readme - this text file The two perl scripts will automatically handle data from forms. Use the post method, and the following form action urls: The form action to use for creating a file of form data is: http://blue1.itc.virginia.edu/~nhb3b/easyform.cgi The form action to use to send form data in email is: http://blue1.itc.virginia.edu/~nhb3b/easymail.cgi Notes: - instructions for anything not explained below (like forwarding mail) can be found at http://www.itc.virginia.edu/ - easyform.cgi concatenates data into the file named output.txt This means that each time the form is submitted, a new record is added at the end of the output.txt file. - easymail.cgi mails the form data to the owner of the account, unless you use the -e installation feature. For example, if your user id is mst3k then normally the email will be sent to: mst3k@virginia.edu You could have the email sent elsewhere. For example, if you wanted to send it to maxheadroom@virginia.edu you would use the command: efsetup -e maxheadroom@virginia.edu - both scripts keep the field names in the file formkeys.dat - if you transfer output.txt to your microcomputer and put it into a spreadsheet, the names of the columns are the field names found in the file formkeys.dat - use an ftp program like WS Ftp, Cute FTP, or Fetch to transfer files. - if you delete a field from your form, that column will remain in the data file. Old data in that column will be preserved. New form data will ignore that column, and so the column will contain empty strings for records entered after you deleted the field. - if you add a new field, it is added to the end of the data record. - because of the above two features, you don't need to modify any files when you modify your form. - if you want to modify the form, and rearrange the data file, then you must copy the two files (output.txt and formkeys.dat) to different file names. You must do this either from Umenu, or the Unix prompt. For example at the unix prompt type: cd public_html cp output.txt output.txt.save cp formkeys.dat formkeys.dat.save After doing that, submit your form, and two new files (still named output.txt and formkeys.dat) will be created with the new form field order.