[IMAGE]
   copyright
   
   Last Modified: 
   
     _________________________________________________________________
   
GUESTBOOK TOOL (ver. 1.08)

   This is Readme file for Guestbook Tool. You can set it to record
   messages, home page and e-mail of those who visit you WWW documents,
   through form interface. Here is an example of the form in English and
   in Japanese and this is an example of the list of visitors.
   
1. How to get the package?

   Get the package form here:
          
          
          ftp_icon guest_home-1.08.tar.gz (11.9K)
          
   
   
   
     _________________________________________________________________
   
2. Package

   This package includes:
   
    1. guest_home.cgi
       A perl (ver. 4.x and 5.x) code that should be placed in your
       cgi-bin directory.
    2. record.html
       A html file containing a form to get the data from the visitors
       (in English).
    3. record_j.html
       A html file containing a form to get the data from the visitors
       (in Japanese).
    4. Copying
       GNU Copyright terms.
    5. Readme
       Text version of this file.
       
   
   
   
     _________________________________________________________________
   
3. Installation

    1. You have to keep two publicly readable and writable files in your
       document structure. These are given at the top of the
       guest_home.cgi file. Edit the guest_home.cgi according to your
       system. Note that both visit_log and record_log files should be
       placed ina directory which is accessible to public and publicly
       writeable, under your document structure. If you put your html
       files in
       /usr/local/etc/httpd/htdocs
       then
       /usr/local/etc/httpd/htdocs/tmp
       is a good choice. Change the permission of the tmp directory to
       777.
       (i.e. $ chmod 777 /usr/local/etc/httpd/htdocs/tmp)
    2. Place guest_home.cgi in your cgi-bin directory. Be sure to make it
       executable by giving the 755 permission to it.
       (i.e. $ chmod 755 guest_home.cgi )
    3. Place the record.html in your html directory hierarchy.
    4. Edit record.html file and set the path for the guest_home.cgi file
       in the FORM definition, near the top of this file.
    5. By calling
       http://your.host.domain/~your_name/dir1/dir2/record.html and
       filling in the form you can log visitors home page.
    6. That is all!!
       
   
   
   
     _________________________________________________________________
   
4. Bug reports

   This code has been tested on NCSA httpd 1.5.1, Netscape Commerce
   Server 1.12, Enterprise Server 3.6 using SunOS 4.1.4_U1, Solaris 2.5,
   6, 7, and 8 for SPARC and Solaris 5, 6, 7, and 8 for x86. Please
   contact the author for bug reports, comments, suggestions and
   questions. My e-mail and address are given at the bottom of this file.
   
   
   
     _________________________________________________________________
   
   
   
5. Copyright Terms

   
   
      USING AND COPYING THIS PACKAGE IS PERMITTED CONDITIONALLY FOR
      EDUCATIONAL, CHARITY AND PERSONAL PURPOSES ONLY, PROVIDED THAT THE AUTHOR
      AND COPYRIGHT TAGS ARE KEPT UNCHANGED. ANY USE OF THE SOURCE CODE AND
      THIS PACKAGE IN A COMMERCIAL PRODUCT OR A COMMERCIAL SERVICE IS NOT
      ALLOWED AND NOT INCLUDED UNDER THIS LICENSE. THIS SOFTWARE IS MADE
      AVAILABLE AS IT IS, WITH NO WARRANTY ABOUT THE SOFTWARE ITSELF OR ITS
      PERFORMANCE OR ITS CONFORMITY TO ANY SPECIFICATION. PLEASE READ THE
      COPYING TERMS AND CONTACT THE AUTHOR FOR ANY QUESTIONS.
      
   
   
   
     _________________________________________________________________
   
6. Author:

     Behrouz H. Far
     Department of Information and Computer Sciences,
     Saitama University
     255 Shimo-okubo, Urawa 338-8570, JAPAN
     Tel. +81-48-858-9612
     Fax. +81-48-858-3716
     
   
     _________________________________________________________________
   
   
    far e-mail cit.ics.saitama-u.ac.jp