home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1997 May / PCO_5_97.ISO / FilesBBS / OS2 / WWWCNT23.ARJ / WWWCNT23 / WWWCNT23.ZIP / readme.os2 < prev    next >
Encoding:
Text File  |  1996-10-19  |  7.0 KB  |  151 lines
  1. README for Count 2.3 for OS/2
  2. -----------------------------
  3.  
  4. Count provides a combination web page hit counter, clock, and date cgi program
  5. for your web server.  Use your favorite web browser to read DOCS/COUNT.HTML or
  6. visit http://www.fccc.edu/users/muquit/Count.html for a complete list of
  7. features.
  8.  
  9.  
  10. Quick and dirty install :
  11.  
  12. Simply use Info-ZIP's unzip.exe 5.12 or any other equivalent unzip utility that
  13. preserves directories to extract the contents of the archive directly into your
  14. cgi-bin directory.  Install the EMX 0.9c runtime .DLLs.  Edit
  15. WCOUNT\CONF\COUNT.CFG.  Get around to deleting the DOCS directory, README.OS2,
  16. and SRC_OS2.ZIP when you feel like it.
  17.  
  18.  
  19. Normal install :
  20.  
  21. 1. Install the EMX 0.9c runtime support package (EMXRT.ZIP) on your system.
  22.    Simply copy the .DLLs contained in EMXRT.ZIP to a directory in your LIBPATH.
  23. 2. Copy the executable file COUNT.EXE to your cgi-bin directory.
  24. 3. Copy the directory WCOUNT and its subdirectories to your cgi-bin directory.
  25.    You should not change the name or location of this directory.
  26. 4. Edit the small commented text file WCOUNT\CONF\COUNT.CFG as appropriate for
  27.    your site.  You will probably need to use your favorite web browser to read
  28.    the documentation in DOCS\COUNT.HTML in order to understand what some of the
  29.    configuration options mean when editing the WCOUNT\CONF\COUNT.CFG file.
  30. 5. Add the counter to your web pages and begin using them.  Refer to
  31.    DOCS\COUNT.HTML and DOCS\COUNT2EX.HTML for complete descriptions of the
  32.    various options and numerous examples.  You should use count.exe in your
  33.    HTML files rather than count.cgi.
  34. 6. Visit http://www.fccc.edu/users/muquit/Count.html for the latest version of
  35.    the documentation and other news.
  36. 7. Visit Digit Mania at http://www.digitmania.holowww.com/ to download hundreds
  37.    of different typestyles for you to use with your new counter.
  38.  
  39. For example:
  40.    You should have directories similar to
  41.       D:\TCPIP\WWW\CGI-BIN\wcount\conf
  42.       D:\TCPIP\WWW\CGI-BIN\wcount\data
  43.       D:\TCPIP\WWW\CGI-BIN\wcount\digits
  44.       D:\TCPIP\WWW\CGI-BIN\wcount\log
  45.       D:\TCPIP\WWW\CGI-BIN\wcount\digits\A
  46.       D:\TCPIP\WWW\CGI-BIN\wcount\digits\B
  47.       D:\TCPIP\WWW\CGI-BIN\wcount\digits\C
  48.       D:\TCPIP\WWW\CGI-BIN\wcount\digits\D
  49.       D:\TCPIP\WWW\CGI-BIN\wcount\digits\E
  50.    and files similar to
  51.       D:\TCPIP\WWW\CGI-BIN\count.exe
  52.       D:\TCPIP\WWW\CGI-BIN\wcount\rgb.txt
  53.       D:\TCPIP\WWW\CGI-BIN\wcount\conf\count.cfg
  54.       D:\TCPIP\WWW\CGI-BIN\wcount\data\sample.dat
  55.       D:\TCPIP\WWW\CGI-BIN\wcount\digits\A\strip.gif
  56.       D:\TCPIP\WWW\CGI-BIN\wcount\digits\B\strip.gif
  57.       D:\TCPIP\WWW\CGI-BIN\wcount\digits\C\strip.gif
  58.       D:\TCPIP\WWW\CGI-BIN\wcount\digits\D\lenna.gif
  59.       D:\TCPIP\WWW\CGI-BIN\wcount\digits\D\strip.gif
  60.       D:\TCPIP\WWW\CGI-BIN\wcount\digits\E\strip.gif
  61.  
  62.  
  63. Upgrading from 2.2 :
  64.  
  65. If you have the 2.2 or earlier version for OS/2 installed you should delete the
  66. old version before installing this version using the instructions above.  You
  67. can keep your old data files.  You can also keep your fonts however you must
  68. either use MKSTRIP.EXE to turn the individual digit files into a single strip,
  69. or you must modify your HTML code to include the ISTRIP=F option.  Refer to
  70. DOCS/COUNT.HTML for information about using MKSTRIP.EXE and/or ISTRIP=.
  71.  
  72.  
  73. Using the package:
  74.  
  75. Refer to DOCS\COUNT.HTML and DOCS\COUNT2EX.HTML for complete descriptions of
  76. the various options and numerous examples.  Visit
  77. http://www.fccc.edu/users/muquit/Count.html for the latest version of the
  78. documentation and other news.
  79.  
  80. You can delete the WCOUNT\DIGITS\D\LENNA.GIF file if you wish, it is simply
  81. used by one of the examples in order to show how the image= tag is used.  The
  82. WCOUNT\DATA\SAMPLE.DAT file can also be deleted.  Overtime you will have many
  83. files in the WCOUNT\DATA directory, a log file WCOUNT\LOG\COUNT23.LOG, and
  84. possibly many more directories in WCOUNT\DIGITS.
  85.  
  86.  
  87. The source code:
  88.  
  89. The COUNT.EXE and MKSTRIP.EXE files included were compiled using EMX 0.9c, thus
  90. they require that you have installed the EMX 0.9c runtime support .DLLs.
  91. These .DLLs are available on most OS/2 sites in the archive EMXRT.ZIP.
  92.  
  93. It took significantly more time to write this readme file than it did to
  94. recompile the code for OS/2.  This can hardly be called a port since there were
  95. essentially no changes required to compile the original source code for the
  96. OS/2 environment.
  97.  
  98. SRC_OS2.ZIP contains the OS/2 specific files required to build the executables
  99. (3 makefiles, config.h, main.c with 1 line added, mkstrip.c with 1 line added).
  100. You will need to download the original source archive from
  101. http://www.fccc.edu/users/muquit/Count.html if you plan to build your own
  102. version of the code.
  103.  
  104. I do not use EMX normally (as a matter of fact I downloaded and installed it
  105. just to do this) so these makefiles are far from optimal.  For the most part I
  106. simply allowed the compiler to run with the defaults, a few defines that
  107. appeared to be good defaults for the source code, and defines that seemed to be
  108. appropriate to fix anything GCC complained about (e.g. using flock and mktime).
  109. The result is a clean compile with no significant changes to the original
  110. source code and a stable resulting .exe.
  111.  
  112. Before anybody asks... the WCOUNT directory is a hardcoded name because I did
  113. not want to spend the time required to add a configureable directory name to
  114. the original UNIX source code.  Ignoring the time to setup and figure out
  115. makefiles for EMX, the entire port took only a few minutes, so I am not about
  116. to spend hours reading the source code in order to figure out and remove a
  117. minor inconvenience.  The support for a configureable directory in the 2.2
  118. release does not exist in this release of 2.3 (and did not work properly in
  119. 2.2 for that matter).
  120.  
  121.  
  122. Compatibility and support:
  123.  
  124. I have only tested the code on my own server (IBM Connection Server 4.1 for
  125. OS/2) and my development machine (straight from command line).  It should work
  126. with goserve or any other OS/2 web server, but I leave it to the users and
  127. newsgroups to figure out which combinations work and which do not.  In a
  128. suitable EMX or RSX environment this executable should run under a DOS web
  129. server as well if such a beast exists.
  130.  
  131. If you receive an OS/2 error message similar to
  132.    SYS1804: The system cannot find the file EMX.
  133. then you have not followed the first step of the installation instructions by
  134. successfully installing the EMX 0.9c runtime.  At the very minimum you need:
  135.  9-08-96   6:42p     81982           0  emx.dll
  136.  9-08-96   6:40p    144963           0  emxlibcm.dll
  137.  
  138.  
  139. Please review DOCS\COUNT.HTML  DOCS\COUNT2EX.HTML
  140. http://www.fccc.edu/users/muquit/Count.html and the various appropriate
  141. newsgroups before contacting me for assistance.  When time allows I will try to
  142. respond to e-mail questions.
  143.  
  144.  
  145. Thanks,
  146. Doug Shields (dshields@direct.ca)
  147.  
  148.  
  149. Count was written by Muhammad A Muquit (ma_muquit@fccc.edu)
  150. The OS/2 version was compiled and packaged by Doug Shields (dshields@direct.ca)
  151.