home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / pascal / library / dos / topaz / qnr / read.me < prev   
Text File  |  1991-08-14  |  5KB  |  140 lines
  1. QNR - V01.00
  2. (C)opyright 1991 - Caboose Software Engineering
  3.  
  4. ------------
  5. INTRODUCTION
  6. ------------
  7.  
  8. QNR, or Query N' Report,  was developed to provide a more powerful filter for
  9. Topaz.  Currently, user defined queries were difficult or impossible.  Now,
  10. with the additon of the initial release of QNR, the filter can be a powerful
  11. xBase like query.  The query is built ala a dBase III+ Assist query build, but
  12. can also be typed in on a command line and parsed.  For syntax sake, the first
  13. method is preferred and recommended.
  14.  
  15. For those of you creating professional systems in Topaz, I promise you that 
  16. this unit is now and will progress to be a powerful query add-on.  As with
  17. typical xBase filters and even Topaz filters, the speed of a system utilizing
  18. a query is greatly reduced.  But for subsets and reports, QNR is truly
  19. invaluable.
  20.  
  21. As in virtually the first release of all units hacked together to fill a
  22. specific need, there are some powerful features and some noticable ommissions.
  23. As comments, and registrations, come in I will gladly update the software
  24. to include a host of powerful features.
  25.  
  26. --------------
  27. FILES INCLUDED
  28. --------------
  29.  
  30. READ.ME     - This file of limited documentation.
  31. QNR.HED     - Header file for QNR.
  32. QNR.TPU     - A pre-compiled TPU, using Turbo Pascal 6.0 and Topaz 3.0.
  33. QNRDEMO.PAS - A demonstration program showing a possible QNR implementation.
  34. QNRDOT.PAS  - A program to simulate a "dot prompt" query.
  35.  
  36. ----------------
  37. WHERE TO GET QNR
  38. ----------------
  39.  
  40. The latest shareware release of QNR can be downloaded from the following
  41. BBS systems:
  42.  
  43. Software Science BBS @ 1-415/467-6786
  44. Programmers Corner   @ 1-301/596-1180
  45.  
  46. or you can always receive the absolute latest version directly from
  47. the author for the $25 registration fee at his Silver Spring address.
  48.  
  49. -----------------
  50. ROUTINES INCLUDED
  51. -----------------
  52.  
  53. Procedure GetQuery ( VAR QueryString : String );
  54.    + This procedure is similar to assist and can be used to retrieve a
  55.      query in a QNR syntactically correct format.
  56.  
  57. Function ProcessQuery : Boolean;
  58.    + This function validates whether a query is valid for processing.
  59.  
  60. Function ParseQuery : Boolean;
  61.    + This function is used as the actual SET_FILTER_TO() condition.  Please
  62.      note that the string which contains the query to be processed MUST be
  63.      moved into QueryString.
  64.  
  65. Procedure InitializeQuery;
  66.    + This procedure initializes the internal tables for the query function.
  67.      It is recommended that this is only initialized before a ProcessQuery
  68.      call.
  69.  
  70. ----------------------
  71. HOW TO INCORPORATE QNR
  72. ----------------------
  73.  
  74. The best suggestions I have is to closely examine the demonstration included
  75. in this ZIP file, QNRDEMO.  A long tutorial of QNR is not necessary nor
  76. is it going to happen in this short READ.ME.
  77.  
  78. You will note that you can type in a condition based on another field.  Try
  79. a query like 'AGE > WIFES_AGE' to compare fields within a database instead
  80. of versus a literal value.  This feature was just added so there may be bugs
  81. related to this.
  82.  
  83. Also note that a string must be enclosed with double quotes, not single.  For
  84. example:
  85.  
  86.    STATE = "MD" is valid but,
  87.    STATE = 'MD' is not.
  88.  
  89. -----------------------
  90. WHAT'S IN STORE FOR QNR
  91. -----------------------
  92.  
  93. + Data dictionary support.
  94. + Relational database support.
  95. + The R.  In other words, a configurable report writer and generator.
  96. + Possibly a unit to graph dBase data.
  97. + More intelligent parser for "dot prompt" entry.
  98. + Ability to edit, expand and contract queries.
  99. + Expanded demonstration software supporting cataloging frequent queries.
  100. + Support of non-exact queries via UPPERCASE conversion of data.
  101. + Increase in speed of query processing via assembler routines.
  102.  
  103. ------------
  104. REGISTRATION
  105. ------------
  106.  
  107. If you find QNR useful in your computing activities, please consider
  108. sending a donation to cover development time and ingenuity.  If you use QNR
  109. in your systems, please think of life without this valuable unit! A $25
  110. donation is suggested, which I believe is an extremely reasonable sum for
  111. this initial release.  Registered users will receive a free upgrade to the
  112. all minor releases of QNR, and a substantial discount on any major releases.
  113. If you send a diskette with a pre-stamped (three stamps) disk mailer, I will
  114. send along the latest version of QNR and any other shareware utilities I have
  115. produced.  Source code for all Caboose Software Engineering software is
  116. available on request for an additional cost.
  117.   
  118. All shareware libraries may freely distribute this package provided I am
  119. notified of the inclusion.
  120.  
  121. Thanks for your support.  As always, comments are welcome and appreciated.
  122.  
  123. -Barry Smith
  124.  
  125. Caboose Software Engineering
  126. 2921 Bluff Point Lane
  127. Silver Spring, MD  20906
  128. 301/460-1437
  129.  
  130. ----------------
  131. REVISION HISTORY
  132. ----------------
  133.  
  134. V01.00 (09 Aug 91)
  135.  
  136. o First public release.  Written in Turbo Pascal 6.0 using the Topaz
  137.   commercial dBase library.
  138.  
  139.  
  140.