home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: Java / Java.zip / rdb084r2.zip / Readme.1st < prev    next >
Text File  |  1997-03-19  |  7KB  |  181 lines
  1. This is the readme.1st file for RXDbase and MaxBase.
  2.  
  3. HOW TO GET 'LATEST AND GREATEST'
  4. "'"'"'"'"'"'"'"'"'"'"'"'"'"'"'"'
  5.  
  6. Just jump to http://www.GeoCities.com/SiliconValley/Park/4218/
  7.  
  8.  
  9. DIFFERENCES FROM 0.84R1 and 0.83
  10. "'"'"'"'"'"'"'"'"'"'"'"'"'"'"'"'
  11.  
  12. .) Included the right MaxBase.class (hem)
  13. .) Corrected the documentation.
  14. .) Added the runme.cmd, runme.bat batch file for OS/2 and Windows users.
  15. .) Corrected a bug in RXDbase: sometime adding a record made the library crash.
  16. .) Thanks to Giuseppe Aprile, now MaxBase can convert its archives to and
  17. from DB III / IV.
  18. .) You can now scroll, in MaxBase, the archive also horizontally 
  19.    (I have used Jesse Hammons' ScrollPanel class).
  20.  
  21.  
  22. INSTALLATION AND FIRST STEPS
  23. "'"'"'"'"'"'"'"'"'"'"'"'"'"'
  24.  
  25. QuickStart:
  26. just unzip plugins.zip (or MACplug, UNIXplug if you use Macs or Unices), then 
  27. type 'java MaxBase' and, via the GUI, connect to the database "imgs.dat".
  28. Select one or all of the entries in the database and click on the 
  29. "view text/image" button.
  30. runme.cmd, runme.bat batch files are provided for OS/2 and Windows users.
  31.  
  32.  
  33. Warning: 
  34. ----------------------------------------------------------------------
  35. this package was created using NetRexx, a compiler which generates
  36. Java code. The programs generated by it (and all the programs here are such)
  37. need the NetRexx classes. A copy of these is here in this package, 
  38. file NetRexxR.zip. Just copy NetRexxR.zip in a directory that's in your
  39. CLASSPATH environment variable, and you're OK (no need to unzip them).
  40. Be sure to have .\. (./. or whatever your OS needs) in the classpath environment
  41. variable. 
  42.  
  43. Read also the file 'license.txt' in the netrexx\lang directory that resides in
  44. NetRexxR.zip, because it contains the user license for those NetRexx classes. 
  45. License.txt doesn't apply to RXDbase and MaxBase, though: for those two, refer 
  46. to the .doc accompanying them.
  47. ----------------------------------------------------------------------
  48.  
  49. If you're interested in plugins for MaxBase and are using WinXX or OS/2, also 
  50. unzip the file plugins.zip.
  51. If you are using a Mac unzip macplug.zip, and finally for Unix unzip unixplug.zip.
  52. Those packages differ for the included databases (in WinXX and OS/2 you have 
  53. newline = \r\n, in Mac = \r and in Unix = \n) and plugin.ini.
  54.  
  55. Done those, you can read the RXDbase or RXFile documentation, and/or study
  56. the *.nrx examples that came with them, and/or just have a look at MaxBase
  57. by issueing 'java MaxBase' (again, 'javapm MaxBase' if you do this in
  58. OS/2).
  59.  
  60.  
  61. PLATFORM CONSIDERATIONS
  62. "'"'"'"'"'"'"'"'"'"'"'"
  63.  
  64. Important: there are bugs in the 1.0.2 JVM garbage collection;
  65. they show up quite quickly in a program like MaxBase.
  66.  
  67. Expecially if you're using OS/2 Warp Java VM do the following;
  68. *) When you launch MaxBase, launch it with the following command:
  69. javapm -ms16M -noasyncgc MaxBase
  70. *) For other applets, run them with the option -noasyncgc, i.e.:
  71.  
  72. java -noasyncgc AppletName
  73.  
  74. That should fix it. If it does not, file a problem report to maxmars@pianeta.it .
  75. (Yes, that's me)
  76.  
  77. There are problems in both the current 1.0.2 beta and in the 1.0.1 release versions, and IBM is looking at them.
  78.  
  79.  
  80. PLEASE BE VOCAL
  81. "'"'"'"'"'"'"'"
  82.  
  83. Yes, I need _your_ feedback on errors, incompatibilites, suggestions, etc.
  84. So far I'm testing it only on the OS/2 platform. I'd be interested on
  85. feedback also from users of other O.Ss. and platforms.
  86.  
  87.  
  88. TAKE THE SURVEY
  89. "'"'"'"'"'"'"'"
  90.  
  91. I started all this some months ago, without knowing what seriously could be done 
  92. with Java; precedently I have coded other databases in a variety of languages
  93. (Rexx, C, C++) and now I have a better understanding of the Java capabilities
  94. thanks to this implementation of my core routines.
  95.  
  96. What I need right now is to know how do _you_ are using MaxBase or RXDbase, what
  97. would you like it to become, what do you think are its main strong point, the
  98. weak ones, and so on.
  99. Please take the time to fill out this little survey; I think that letting anyone 
  100. have a look at the development of this database (and a chance to improve it, 
  101. with your suggestions) is a thought worth the time that you will spend here. 
  102. Thans!
  103.  
  104. Ah, I forgot: those infos will be highly confidential. I promise I *won't* 
  105. give them to anyone (the only exception is that maybe I will publicly report
  106. the percentage of users divided for the platform, i.e. 15% Linux, 
  107. 20% MacIntosh, etc).
  108.  
  109. E-mail a copy of this form, of course after having filled it, to:
  110.  maxmars@pianeta.it (Internet)
  111.  2:332/529.12       (Fidonet)
  112.  
  113. ---------8<--------------------------8<----------------------8<------------------
  114.  
  115. Personal infos:
  116. "'"'"'"'"'"'"'"
  117. Name: ________________________________________________________
  118.  
  119. Surname: _____________________________________________________
  120.  
  121. E-mail address: ______________________________________________
  122.  
  123. Age: ___ , Sex: ___
  124.  
  125. [ ] I am a student.
  126. [ ] I am employed.
  127. [ ] I am none of the above.
  128.  
  129.  
  130. Use of MaxBase:
  131. "'"'"'"'"'"'"'"
  132.  
  133. [ ] I use MaxBase (the graphical front-end for RXDbase).
  134. [ ] I use RXDbase (the db class).
  135.  
  136. [ ] I use it/them for my work.
  137. [ ] I use it/them at home.
  138.  
  139.  
  140. Platform(s) used for running MaxBase:
  141. "'"'"'"'"'"'"'"'"'"'"'"'"'"'"'"'"'"'"
  142.  
  143. [ ] MacIntosh
  144. [ ] OS/2
  145. [ ] Linux
  146. [ ] Other Unices
  147. [ ] Windows 95
  148. [ ] Windows NT
  149. [ ] Other (Please specify: _______________________)
  150.  
  151.  
  152. License of MaxBase/RXDbase:
  153. "'"'"'"'"'"'"'"'"'"'"'"'"'"
  154.  
  155. MaxBase/RXDbase will be enhanced from now to 1.0 (MaxBase will
  156. see a major cosmetic re-write, for example), then it will go
  157. shareware.
  158.  
  159. Note: 
  160.  *) Std Edition: the package which will include binaries for RXFile
  161.     and RXDbase, source + binaries for MaxBase, docs, examples and a
  162.     couple of plug-ins. All the other versions are differentiated by
  163.     the price.
  164.  *) Academic version: aimed at students.
  165.  *) Business version: > XX copies will cost as XX copies 
  166.  *) No-profit version: you can have the package for free if you
  167.     use it in a no-profit organization environment.
  168.  
  169. I think that US$__ would be a good price for the standard version.
  170. I think that US$__ would be a good price for the academic version.
  171. I think that US$__ would be a good price for the business version. XX = __.
  172. I think that US$ 0 (zero) is a great price for the no-profit version!
  173.  
  174. Suggestions:
  175.  
  176. ---------8<--------------------------8<----------------------8<------------------
  177.  
  178.  
  179. Ciao and thanks for your time!
  180. Max.
  181.