home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / mac / developm / language / quinta.cpt / Quinta / README < prev    next >
Encoding:
Text File  |  1990-04-04  |  6.2 KB  |  146 lines
  1. Quinta Release Notes
  2.  
  3. Original Release
  4. 4 April 1990
  5.  
  6. This release, in the form of a binhexed stuffit archive should
  7. contain the following files:
  8.  
  9.      Quinta              (the application)
  10.      Quinta.doc          (MS Word 4 documentation file)
  11.      Quinta.doc.txt      (Same as above, only text: first half)
  12.      Quinta.doc2.txt     (Same as above, only text: second half)
  13.      README              (This file)
  14.      Quinta Worksheet    (The interpreter worksheet)
  15.      QCore               (interpreter core file)
  16.      fact.q
  17.      fit.q
  18.      printlist.q
  19.      sieve.q
  20.      mat7.q              (example programs)
  21.  
  22. This version of Quinta is certainly not complete or perfect.  
  23. Several different enhancements are in the works and I struggled 
  24. with choosing when to release a preliminary version.  As the 
  25. Quinta interpreter exists in this release, it is, to the best of my 
  26. knowledge, functional.  The status of the overall project is 
  27. summarized below:
  28.  
  29. Quinta features classes, inheritance (multiple), lists, matrices 
  30. (with determinants and the like), strings, integers, floating 
  31. point, transcendental functions, curve fitting, loops, 
  32. conditionals, comments, multimessages, dates, source 
  33. debugging, error messages, reconfigurable limitations, multiple 
  34. window editing, global and local variables, recursion, privacy, 
  35. user class instance variables, and operator overloading.  The 
  36. above list may be incomplete, but it covers most of high points.
  37.  
  38. The framework for a symbolic math class is nearly complete.  
  39. The class is called expression, and preliminary results are quite 
  40. nice.  The class is expandable in that user objects may be placed 
  41. in expressions with full support.  Currently the class will build 
  42. expressions, evaluate them, print them, and apply a number of 
  43. mathematical properties (ie commutative, distributive...).  
  44. There is a message which converts a floating point number to a 
  45. fraction in the form of an expression.  There is a class imaginary 
  46. which allows complex arithmetic in the form of expressions.  I 
  47. am working on routines to simplify expressions and the 
  48. beginning of a system to do symbolic differentiation.  The class 
  49. may in the future be a framework for equation solving, 
  50. graphing, and the like.  Registered users (see below) will receive 
  51. the expression class with their upgrades.  I choose not to release 
  52. it now partially because it is not functional and partially as an 
  53. incentive to upgrade.
  54.  
  55. Much work has been done on a compiler for the language.  The 
  56. compiling system currently includes an assembler and linker 
  57. which I wrote from scratch..  Using a public domain C compiler 
  58. I crudely ported to the Mac, I have produced VERY simple, but 
  59. functional, applications.  However, to release this system as 
  60. functional to users would be nearly vulgar.  The C compiler is a 
  61. disaster.  The assembler has no error checking and only a few 
  62. instructions are tested rigorously.  Furthermore, I have barely 
  63. begun to write the routines to actually compile Quinta source 
  64. code.  I would consider releasing this work to someone 
  65. knowledgable and interested in getting the C compiler working.  
  66. It's main problem lies in initialized global variables.  It chokes 
  67. on string literals.  Toolbox traps are handled, but I'm not sure 
  68. how correctly.  Global variable allocation is semi-functional.  
  69. The original compiler does not handle bit fields.
  70.  
  71. However, another "compiler" is near completion.  This 
  72. compiler does not generate stand alone applications, but it does 
  73. compile Quinta code into machine language routines.  Any user 
  74. defined response may be compiled.  A compiled response 
  75. operates from the interpreter just as it did before.  A compiled 
  76. response cannot be modifed, but it can be uncompiled back to its 
  77. original state.  I am pondering a way to design an application 
  78. generator around this system.  Even a turnkey type of operation 
  79. would be helpful.  This compiler does no optimizations at this 
  80. time, though the framework exist for them to be implemented in 
  81. the future.
  82.  
  83. Although Quinta has an MPW-like worksheet, Quinta has a 32k limit
  84. to the text its windows.  From the worksheet, you can see how much
  85. text is actually in the worksheet with the message getTElength.
  86.  
  87. Some work has been done in adding a Toolbox Interface to 
  88. Quinta.  The work is totally untested and somewhat incomplete.  
  89. I hope to add some of these messages soon and continue to build 
  90. the toolbox support.  Quinta currently has no provision at all for 
  91. file I/O.
  92.  
  93. The constructs for loops and conditionals are somewhat 
  94. unsatisfactory when considered in a completely object oriented 
  95. framework.  I have implemented them anyway, but the issue is 
  96. yet to be resolved.
  97.  
  98. Quinta includes no support at all for printing or page setup from 
  99. the editor.
  100.  
  101. Quinta currently can do no special numeric formatting.
  102.  
  103. The class structure of Quinta is a incomplete compared to say, 
  104. SmallTalk.
  105.  
  106. The overall performance of the system is somewhat slow.  I 
  107. need to spend some time optimizing important routines.
  108.  
  109. The documentation, is admittedly, rather unorganized and 
  110. somewhat incomplete.
  111.  
  112. One known bug is in the routine which reads user input after 
  113. pressing enter.  If enter is pressed on a blank line, the line above 
  114. the insertion point is read.  Many times this is a comment line, so 
  115. you may never notice this bug.
  116.  
  117. Miscellaneous:
  118.  
  119. I am releasing Quinta as shareware.  Users may register and 
  120. upgrade their copy for $20.  Registered users will receive an 
  121. upgraded version with some assorted goodies.  Registered users 
  122. may upgrade any time later for $5 (essentially the cost of 
  123. processing the order).  The original release is freely 
  124. distributable.  I encourage you to pass it to anyone interested.  I 
  125. also encourage users to register.  Registered versions will not be 
  126. freely distributable.  This does not necessarily mean, however, 
  127. that I will never again make a general release of Quinta.  I retain 
  128. all copyrights and ownership of the software itself, including the 
  129. executable documentation, and source.  I request that all 
  130. documentation, release notes, and example programs that I 
  131. distribute be included when passing Quinta to other users.
  132.  
  133. My address is:
  134.  
  135.     Eric W. Sink
  136.     303 Country Fair Drive, Apt. 69
  137.     Champaign, IL  61821
  138.  
  139. My current email address is
  140.  
  141.     e-sink@uiuc.edu
  142.  
  143. Naturally, bug reports and comments of any kind are more than 
  144. welcome.  Enjoy !
  145.  
  146.