home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / jib1622.zip / README.OS2 < prev   
Text File  |  2000-04-25  |  5KB  |  168 lines
  1. README for OS/2 Port of Jitterbug 1.6.2
  2. ---------------------------------------
  3.  
  4. Warning!
  5. --------
  6.  
  7. This port is a miserable hack, compiled with
  8. IBM VisualAge C++ for OS/2, Version 3. It has
  9. not even been tested very well.
  10.  
  11.  
  12. What is Jitterbug?
  13. ------------------
  14.  
  15. See http://samba.anu.edu.au/jitterbug/
  16.  
  17.  
  18. What do I need to run Jitterbug on OS/2?
  19. ----------------------------------------
  20.  
  21. You need Apache (I'm running 1.3.9). And you
  22. need any SMTP server (mine is IBM OS/2 Sendmail
  23. Version 2.03).
  24.  
  25. Of cause you need OS/2, TCP/IP and a Webbrowser.
  26. I used Netscape 2.02 and 4.61 and Hotjava 3.0.
  27.  
  28. It may be helpful to have an IBM VisualAge C++
  29. compiler and the TCP/IP toolkit.
  30.  
  31. At least, Jitterbug will not run on 8.3
  32. filesystems. You need HPFS, JFS or whatever
  33. may support long filenames.
  34.  
  35.  
  36. Can I modify and recompile the code?
  37. ------------------------------------
  38.  
  39. Did anybody say 'caaaan'? Be prepared, that you
  40. have to. I included my Makefile. If you make sure,
  41. that your compiler finds all TCP/IP include files,
  42. it should compile without problems. However, lots
  43. of warnings will be produced. You probably need
  44. to modify the two .bnd files.
  45.  
  46.  
  47. How do I get help?
  48. ------------------
  49.  
  50. Check http://samba.anu.edu.au/cgi-bin/jitterbug first,
  51. but do not expect any help on this OS/2 port. Check
  52. the source code next.
  53.  
  54.  
  55. Why was this awful port done?
  56. -----------------------------
  57.  
  58. Well...I was looking around the net for some bug
  59. tracking tools, found Jitterbug but wasn't able
  60. to find any OS/2 port.
  61.  
  62.  
  63. Why was this port done that bad?
  64. --------------------------------
  65.  
  66. It may have been much easier using GCC and EMX,
  67. but I'm used to the IBM compiler and there's no
  68. GCC installed around here. I checked the code and
  69. made up my mind. Should be easily done in a few
  70. hours - I thought. Harharhar...
  71.  
  72. After a few hours I pulled my hair again and again.
  73. Da#&% m=%$⌡(f%ck$ng sh&⌡! After adding some more code
  74. stolen elsewhere, it compiled OK, but nothing worked.
  75.  
  76. After some hours more than just a few, I solved some
  77. more porting problems and gave up with others, like
  78. chroot. At least I must say that this beast is not
  79. as portable as I expected.
  80.  
  81.  
  82. Are there any special considerations for this OS/2 port?
  83. --------------------------------------------------------
  84.  
  85. Yes, quite some.
  86.  
  87. The configuration file should be placed in /etc/jitterbug,
  88. sharing the same drive as your cgi-bin directory. The
  89. filename extension must be '.cfg'. The basename is the
  90. name of your PACKAGE, like in the original UNIX version.
  91. And, like with UNIX, change the name of jitterbug.exe
  92. to PACKAGE.exe. If you don't know what I'm talking about,
  93. please read the original documentation first.
  94.  
  95. Leave the 'chroot directory' empty. Here is my PACKAGE.cfg:
  96.  
  97.     from address = jnce-bugs@egnite.de
  98.     chroot directory =
  99.     base directory = /bugtrack/jnce
  100.     guest gid = 65534
  101.     guest uid = 65534
  102.     uid = 1
  103.     gid = 1
  104.     guest download = yes
  105.  
  106. The directory /bugtrack/jnce keeps all the stuff needed:
  107.  
  108.     footer.html
  109.     guest.prefs
  110.     guestintro.html
  111.     header.html
  112.     intro.html
  113.     reportform.html
  114.     users
  115.  
  116. If you ever manage to get it working, Jitterbug will
  117. create more files and subdirectories here.
  118.  
  119. You can't use "gzip encoding", because I commented out
  120. that part.
  121.  
  122. External mailers may not work.
  123.  
  124. For the programmers among you: I didn't use autoconf, awk
  125. and all that script stuff of the original version. So all
  126. modifications are crafted by hand. :-)
  127.  
  128.  
  129. Any more hints?
  130. ---------------
  131.  
  132. You won't be able to see the full thing unless you are
  133. logged in as a user (not guest) via you Webbrowser.
  134. After being logged in as a user other than guest, you
  135. have to set your preferences first.
  136.  
  137. It looks like something is broken with the user name
  138. supplied by Apache, but not sure yet.
  139.  
  140. Most problems I encountered while porting were based
  141. on the fact, that the program does not only jump around
  142. in subdirectories, but also modifies pathnames all
  143. the way long. Sigh!
  144.  
  145. IBM's TCP/IP does not support read() and write() on
  146. socket handles (but my toolkit is not up to date).
  147.  
  148.  
  149. Will this be supported in the future?
  150. -------------------------------------
  151.  
  152. I'm not sure, if I'll ever continue with this, because
  153. I'm not sure right now, if I really need this. My son
  154. already wrote some perl scripts, which our company is
  155. using right now.
  156.  
  157. Anyway, if you are going to use it, let me know.
  158.  
  159.  
  160. harald.kipp@egnite.de
  161.  
  162. *
  163. * $Log: README.OS2,v $
  164. * Revision 1.1  2000/04/25 20:01:12  harald
  165. * First OS/2 release
  166. *
  167. *
  168.