home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / ipo-101.zip / readme.txt < prev    next >
Text File  |  1999-03-09  |  12KB  |  266 lines
  1. ************************************************************************
  2.        Welcome to Irie Pascal 1.01 for OS/2
  3. ************************************************************************
  4.  
  5. The latest information and releases of Irie Pascal are available at
  6. the Irie Tools web site at    http://www.irietools.com
  7.  
  8. Changes in version 1.01:
  9. ------------------------
  10. ** list bug (Deleting the first element).
  11.    In version 1.00 if the first element in a list was deleted then
  12.    if any elements were inserted afterwards then the remaining elements
  13.    in the list would be lost. This bug has been fixed in version 1.01.
  14.  
  15. ** sleep bug
  16.    The compiler was generating incorrect code for the built-in "sleep"
  17.    procedure. This bug has been fixed in version 1.01.
  18.  
  19. ** lexer bug
  20.    If the first non-whitespace character in the source file was undefined
  21.    (i.e. not one of characters defined by Pascal) the compiler would
  22.    attempt to dereference a null pointer. This bug has been fixed in
  23.    version 1.01.
  24.  
  25. ** Relaxed rules for the SHR and SHL operators
  26.    The right operand of the SHR and SHL operators can now be zero.
  27.  
  28. ** Added Borland and Microsoft compatible messages
  29.    The "-mb" and "-mm" compiler options have been added, and cause
  30.    the compiler to generate messages in the same format used by
  31.    Borland and Microsoft compilers. These compiler options were added to
  32.    make it easier to use Irie Pascal with third-party editors and IDE's
  33.    which know how to process Borland and Microsoft compiler messages.
  34.    See "user.txt" for more details.
  35.  
  36. ** Added more info to compiler messages
  37.    Where possible the compiler now displays the subject of the message.
  38.    For example the message "Variable is never used" has been changed
  39.    to "Variable 'x' is never used" (where 'x' is the name of the
  40.    particular variable which is never used).
  41.  
  42. ** nc compiler option
  43.    The name of the compiler option that controls support for nested
  44.    comments was changed from "nc" to "c" in version 1.00 but the
  45.    help screen printed by "ipc ?" did not reflect  this change.
  46.    In version 1.01 the compiler option was changed back to "nc"
  47.    since "c" is reserved to control a compile-only mode which may
  48.    be implemented in the future.
  49.  
  50. ** Programs compiled by the evaluation version now expire the day
  51.    after they are compiled (instead of seven days after).
  52.    This change is intended to encourage more people to register.
  53.  
  54.             ***************************
  55.  
  56. Please make sure that you have the following files:
  57.  
  58. Documentation:
  59. --------------
  60. readme.txt    - This file
  61. user.txt      - The Irie Pascal User's Guide
  62. progref.txt   - The Irie Pascal Programmer's Reference Manual
  63. orderus.txt   - The Order Form for US dollar Registrations
  64. orderca.txt   - The Order Form for Canadian dollar Registrations
  65. orderuk.txt   - The Order Form for UK pound Registrations
  66. shareware.txt - Describes the shareware concept (derived from documentation
  67.         produced by the Association of Shareware Professionals (ASP)).
  68.         NOTE: I am not a member of this association.
  69.  
  70. Programs:
  71. ---------
  72. ipc.exe       - Irie Pascal Compiler for OS/2
  73. ivm.exe       - Irie Virtual Machine Interpreter for OS/2
  74. upgrade.ivm   - Irie Upgrade Utility
  75.  
  76. Sample programs:
  77. ----------------
  78. samples.zip     - ZIP archive of sample programs
  79.  
  80. The sample programs are provided mostly to help you veryify that
  81. Irie Pascal has been installed correctly. You may however find a few of
  82. the sample programs like calc.pas and ascii.pas useful.
  83.  
  84. Irie Pascal consists of a compiler (called the Irie Pascal Compiler) and
  85. an interpreter (called the Irie Virtual Machine Interpreter). The compiler
  86. translates Pascal programs into Irie Virtual Machine executables (IVM
  87. executables). IVM executables can not be directly executed but instead must
  88. be executed by the interpreter. Most other compilers generate "native-code"
  89. executables (i.e. executables which can be directly executed on a single
  90. computer platform but usually can not be executed at all on any other
  91. computer platform). The main advantage of IVM executables is that unlike
  92. "native-code" executables, IVM executables can be run on any computer
  93. platform on which the interpreter exists.
  94. Currently the interpreter exists on five computer platforms:
  95.     1) Windows (i.e. Win95/98/NT)
  96.     2) DOS
  97.     3) Linux
  98.     4) OS/2
  99.     5) FreeBSD
  100.  
  101. Another advantage to IVM executables is that they tend to be much smaller
  102. than their "native-code" equivalents. I have found that IVM executables
  103. tend to be roughly 20 times smaller than equivalent "native-code"
  104. executables.
  105.  
  106. The main disadvantage to IVM executables is speed or rather the lack of it.
  107. This is because IVM executables are not directly executed, but are executed
  108. by the Interpreter. I have found that IVM executables tend to run roughly
  109. 50 times slower than equivalent "native-code" executables. While there are
  110. many kinds of programs where this speed is perfectly acceptable, there are
  111. others where this is just too slow. I expect Irie Pascal to be used mainly
  112. to create utility programs, and programs for learning purposes (if you are
  113. learning Pascal you don't need your test programs to be the fastest possible,
  114. you probably need good compile-time and run-time diagnostics more).
  115.  
  116. You should be aware that although I claim Irie Pascal complies with
  117. ISO/IEC 7185 Level 0 (since it does according to my tests) it has not been
  118. formally certified by an external body.
  119.  
  120. Irie Pascal is shareware and as such there is an evaluation
  121. version and a registered version. The evaluation version of Irie Pascal is
  122. provided at no charge, for the purposes of evaluating Irie Pascal and
  123. deciding whether to continue using it. Feel free to share the evaluation
  124. version with your friends, but do not give it away altered or as part of
  125. another system. You are not authorized to share the registered version.
  126. The essence of "user-supported" software is to provide personal computer
  127. users with quality software without high prices, and yet to provide an
  128. incentive for programmers to continue to develop new products. If you find
  129. the evaluation version of Irie Pascal useful and find that you are using
  130. it and continue to use it after a reasonable trial period, you must
  131. register it (See "How to Register").
  132.  
  133. The evaluation and registered versions of Irie Pascal are functionally
  134. identical except for two differences. The first difference is that the
  135. registered version uses an improved code generation technique to generate
  136. smaller executables. The second difference is that executables compiled by
  137. the evaluation version expire the day after they are compiled, while
  138. executables compiled by the registered version never expire. These
  139. differences are intended to encourage users of the evaluation version to
  140. pay the registration fee and receive a copy of the registered version.
  141. NOTE: Irie Pascal does not prevent users of the evaluation version from
  142. recompiling expired programs as many times as they wish to keep them
  143. running indefinitely.
  144.  
  145. ---------------
  146. How To Register
  147. ---------------
  148. To register Irie Pascal complete the appropriate order form, and mail it
  149. in along with a check or money order for the registration fee. If you wish
  150. to pay the registration fee in US dollars then use the order form in
  151. "orderus.txt". If you wish to pay the registration fee in Canadian dollars
  152. then use the order form in "orderca.txt". If you wish to pay the
  153. registration fee in British pounds then use the order form in "orderuk.txt".
  154. If you include an email address then you will receive an email notification
  155. when you order is shipped. I respect the privacy of my customers and will
  156. NEVER sell or otherwise distribute any information you give me to anyone
  157. without your consent.
  158.  
  159. The check or money order should be made out to "Stuart King" and sent to
  160.  
  161.    Stuart King
  162.    MB #247
  163.    221 S. State Road 7
  164.    Ft. Lauderdale, Fl 33317
  165.    U.S.A.
  166.  
  167. Please do not send cash.
  168.  
  169. All registered users of Irie Pascal will receive a copy of the latest
  170. registered version on 3 1/2" disks, so you will need a 3 1/2" floppy drive
  171. to install Irie Pascal.
  172.  
  173. Registered users of Irie Pascal for OS/2 are entitled to receive
  174. free (regular shipping and handling charges may apply) upgrades to all
  175. registered versions of Irie Pascal for OS/2 released after they register.
  176. Registered users of Irie Pascal for OS/2 may use the Irie Upgrade Utility
  177. to upgrade to the latest registered version at any time. Whenever a new
  178. registered version of Irie Pascal for OS/2 is released a special upgrade
  179. file will be placed on the IrieTools Website. Registered users may download
  180. this upgrade file without charge and perform the upgrade (see the User's
  181. Manual "user.txt" for more information on using the Irie Upgrade Utility).
  182.  
  183. Registered users may also receive upgrades by mail. To receive upgrades
  184. by mail, fill out the appropriate order form and mail in the completed
  185. order form along with a check of money order for the shipping and handling
  186. fee to the address above.
  187.  
  188. Educational institutions should enquire about the educational discount.
  189.  
  190. Commercial users of Irie Pascal must register and pay for their copies of
  191. the Software within 30 days of first use or their license is withdrawn.
  192. Site-License arrangements may be made by contacting the author.
  193.  
  194. Anyone distributing Irie Pascal for any kind of remuneration must first
  195. contact the author.
  196.  
  197. ---------------------------
  198. Minimum system requirements
  199. ---------------------------
  200. - OS/2 2.0 or later
  201. - 1 MB disk space
  202.  
  203. ----------------------
  204. Installing Irie Pascal
  205. ----------------------
  206. Irie Pascal for OS/2 is distributed as a zip file "ipo-101.zip".
  207.  
  208. NOTE: Installing Irie Pascal requires manual modifications to your
  209. config.sys. If you have never modified your config.sys or if you
  210. uncomfortable doing so then have someone who has done this before assist
  211. you. If you decide to modify your config.sys remember to use a text
  212. editor and not a word processor. You may wish to make a backup copy of
  213. your config.sys before you begin making modifications to help you recover
  214. from mistakes.
  215.  
  216. ----------------------------
  217. Installing from the zip file
  218. ----------------------------
  219. The recommended installation procedure is as follows:
  220. A) Create a directory (I suggest "C:\IRIE") to store Irie Pascal.
  221. B) Copy the zip file into this directory.
  222. C) Use your unzip utility to extract the files.
  223. D) Add the directory created in A) to the path
  224.    (i.e. edit your config.sys).
  225. E) Create a directory to store the sample pascal programs
  226.    (I suggest "C:\IRIE\SAMPLES").
  227. F) Copy the zip file containing the samples "samples.zip" in to the
  228.    directory you just created.
  229. G) Unzip the sample files.
  230. H) Reboot your computer.
  231.  
  232. ------------------------
  233. Uninstalling Irie Pascal
  234. ------------------------
  235. Irie Pascal does not make any behind the scenes modifications to your
  236. system. Irie Pascal does not modify any system files or install files
  237. on you hard disk so uninstalling is very simple. Just delete the
  238. directory, you created to store Irie Pascal, and remove it from the path.
  239.  
  240. ---------------
  241. Product support
  242. ---------------
  243. I am very interested in all your comments about Irie Pascal, but
  244. most especially in your comments about its usefulness, any problems
  245. you encounter installing or using Irie Pascal, and any changes you
  246. would like to see.
  247.  
  248. The latest information and updates of Irie Pascal are available at
  249. the Irie Tools web site at    http://www.irietools.com
  250.  
  251. You can also contact me directly with your technical support
  252. questions.
  253.  
  254. ---------------------
  255. Contacting the author
  256. ---------------------
  257. For the quickest response contact me by e-mail at support@irietools.com
  258.  
  259. If you prefer you can contact me by regular mail (but this takes longer) at:
  260.    Stuart King
  261.    MB #247
  262.    221 S. State Road 7
  263.    Ft. Lauderdale, Fl 33317
  264.    U.S.A.
  265.  
  266.