home *** CD-ROM | disk | FTP | other *** search
/ Turbo Toolbox / Turbo_Toolbox.iso / turbo3 / read.me < prev    next >
Encoding:
Text File  |  1985-04-17  |  9.4 KB  |  260 lines
  1.  
  2.                   Welcome to TURBO PASCAL Version 3.0!
  3.                   ------------------------------------
  4.  
  5.     In  spite  of all efforts,  some errors have found their way into
  6.     the new TURBO 3.0 manual.   This file contains all necessary cor-
  7.     rections  and  additions,  and we apologize for any inconvenience
  8.     this may cause you.
  9.  
  10.     At  the  end  of this file,  you will find a summary  of the  new
  11.     features introduced in version 3.0 and a list of additional files
  12.     present on your TURBO disk.
  13.  
  14.  
  15.               *******************************************
  16.               *                                         *
  17.               *   Need help  with TURBO?  Please  see   *
  18.               *   Appendix N in your Reference Manual   *
  19.               *   for answers to common questions.      *
  20.               *                                         *
  21.               *******************************************
  22.  
  23.  
  24.                          -------------------
  25.  
  26.                              CORRECTIONS
  27.                              -----------
  28.  
  29.  
  30. Page 253 - MOV AL,[BP-1]
  31. ------------------------
  32.      The correct statement is:  MOV AL,[BP+4]
  33.  
  34.  
  35. Page 293 - TURBO-BCD will compile and run any program
  36. -----------------------------------------------------
  37.      Well - almost. The Real functions Sin, Cos, ArcTan, Ln, Exp,
  38.      and Sqrt and the pre-declared constant Pi are not  available
  39.      in  TURBOBCD.
  40.  
  41.  
  42.  
  43.                          -------------------
  44.  
  45.  
  46.                               OMISSIONS
  47.                               ---------
  48.  
  49.  
  50.  
  51. User Written Error Handlers
  52. ---------------------------
  53.      In  Turbo Pascal 3.00 you may write your own error  handler,
  54.      which  is  called in case of an I/O or Run-time  error.  The
  55.      procedure must have the following header:
  56.  
  57.           procedure Error(ErrNo, ErrAddr: Integer);
  58.  
  59.      The  name of the  procedure  and its  parameters  are  unim-
  60.      portant,  as  long   as  it  is a procedure with  two  value
  61.      parameters  of  type Integer.
  62.  
  63.      The value passed in ErrNo is the error type and number.  The
  64.      most significant byte,  i.e. "Hi(ErrNo)", contains the error
  65.      type,  and  the least significant byte,   i.e.  "Lo(ErrNo)",
  66.      contains the error number (see Appendix F or G in the  Turbo
  67.      Pascal Manual).
  68.  
  69.      The following error types are defined:
  70.  
  71.           0   User Break (Ctrl-C).
  72.           1   I/O error.
  73.           2   Run-time error.
  74.  
  75.      In  case  of  a user interrupt (Ctrl-C),   the low  byte  of
  76.      "ErrNo" is always 1.  "ErrAddr" contains the address (offset
  77.      in Code Segment for 16 bit versions) of the error.
  78.  
  79.      To  activate the error handler,   assign its offset  address
  80.      to  the standard variable "ErrorPtr", i.e.
  81.  
  82.           ErrorPtr:=Ofs(Error);  { 16 bit }  or
  83.           ErrorPtr:=Addr(Error); {  8 bit }
  84.  
  85.      There are no limits to what an error handler may  do.  Typi-
  86.      cally  it will close all open files,   output an error  mes-
  87.      sage, and call the Halt  standard procedure to terminate the
  88.      program.   If  an  error handler returns,   i.e.  if it does
  89.      not  call  Halt,   or  if an error occurs  within  an  error
  90.      handler,   Turbo Pascal will itself output the error message
  91.      and terminate the program.
  92.  
  93.  
  94.  
  95.  
  96.                          -------------------
  97.  
  98.  
  99.                 OVERVIEW OF NEW FEATURES OF TURBO 3.0
  100.                 -------------------------------------
  101.  
  102. A program that was written using TURBO 2.0 may behave differently
  103. using TURBO 3.0:
  104.  
  105.     - TURBO no longer does a ClrScr when your program first begins.
  106.     - TURBO no longer does a  GoToXY(1, 25) when your program terminates.
  107.     - The use of file handles now necessitates closing all files  -- even
  108.       if they were not modified.    You should also place a  "FILES = 20"
  109.       statement in your CONFIG.SYS file.   Note that DOS always uses five
  110.       file handles  (standard input,  output, error,  auxillary, standard
  111.       printer).   Please refer to your DOS technical reference manual for
  112.       more information about DOS file handles.
  113.     - The handling of some logical  devices has been  changed to  conform
  114.       with standard Pascal and with TURBO's handling of other files:
  115.  
  116.         1.  A read statement using the logical device TRM is now buffered
  117.             and terminates with a <CR>.
  118.         2.  The KBD device is not buffered.  For this reason,  look-ahead
  119.             functions (EOF, EOLN, readln) used on the KBD device will al-
  120.             ways "wait" for a key to be pressed.
  121.  
  122. TINST Installation
  123. ------------------
  124.  
  125.      TINST now allows you to install a pathname which is used by TURBO
  126.      when loading the error message file (TURBO.MSG).
  127.  
  128.      IBM PC Implementation only
  129.      --------------------------
  130.         In the screen installation, after choosing your display type, the
  131.         following question will appear:
  132.  
  133.            Does your screen blink when the text scrolls? (Y/N):
  134.  
  135.         If the screen is "snowy" in the TURBO editor,  answer "Y" to
  136.         this question.
  137.  
  138.  
  139. Chain and Execute
  140. -----------------
  141.      Heap preserved during Chain (MS/PC-DOS & CP/M-86).
  142.  
  143.      Chain  and Execute no longer set a flag in the command  line
  144.      parameter.
  145.  
  146.  
  147. Inline
  148. ------
  149.      A constant identifier used in an INLINE statement does  not
  150.      always generate two bytes of code.
  151.  
  152. Files
  153. -----
  154.      Append procedure (MS/PC-DOS).
  155.      Full DOS path-name supported (MS/PC-DOS).
  156.      I/O re-direction (MS/PC-DOS).
  157.      New FIB formats.
  158.      Optional parameter on text file declaration sets buffer size
  159.      (MS/PC-DOS & CP/M-86).
  160.      Optional  parameter  on Reset/ReWrite sets record  size  for
  161.      untyped files (MS/PC-DOS).
  162.      Optional 4th parameter on Blockread/Write sets block size.
  163.      Read and ReadLn work with array of char (MS/PC-DOS & CP/M-86).
  164.      Seek procedure may take Real argument (MS/PC-DOS).
  165.      SeekEoln function.
  166.      SeekEof function.
  167.      Truncate procedure (MS/PC-DOS).
  168.  
  169. Misc.
  170. -----
  171.      ChDir procedure (MS/PC-DOS).
  172.      Command line parameters on Options menu (MS/PC-DOS and CP/M-86).
  173.      Delay procedure independent of processor speed (PC-DOS).
  174.      Exit procedure.
  175.      Extended  graphics procedures & functions  (see page 309  in
  176.      manual for overview).
  177.      GetDir procedure (MS/PC-DOS).
  178.      MkDir procedure (MS/PC-DOS).
  179.      Multiple EXTERNAL subprograms in one file (MS/PC-DOS & CP/M-86).
  180.      Optional parameter on Halt to return error code (PC/MS-DOS).
  181.      OvrPath procedure (MS/PC-DOS).
  182.      OvrDrive procedure (CP/M).
  183.      ParamCount function.
  184.      ParamStr function.
  185.      RmDir procedure (MS/PC-DOS).
  186.      Runs overlays in Memory mode (MS/PC-DOS & CP/M-86)
  187.      Turtlegraphics  procedures,  functions,  and constants  (see
  188.      page 309-310 in manual for overview).
  189.  
  190.  
  191. Overlays
  192. --------
  193.      Overlays can be run in Memory mode (MS/PC-DOS & CP/M-86).
  194.  
  195.      Overlay  files  are  opened and closed every time  they  are
  196.      accessed.  Therefore,  there is never a need to specifically
  197.      close  an  overlay file.
  198.  
  199.      The  Y compiler directive is no longer  supported.  Instead,
  200.      the   OvrPath (MS-DOS) or OvrDrive (CP/M)  standard   proce-
  201.      dures   may  be  used to specify the drive and  subdirectory
  202.      in which overlay files reside.
  203.  
  204.  
  205.                          -------------------
  206.  
  207.                       TURBO PASCAL Version 3.0
  208.  
  209.                         Additional File List
  210.  
  211.      In addition to the list  of files  mentioned in  Chapter 1 of
  212.      your TURBO Reference Manual, the following files are included
  213.      on your TURBO disk:
  214.  
  215.      ACCESS3  BOX    - for TOOLBOX users only: ACCESS.BOX update
  216.  
  217.      Sample programs
  218.      ---------------
  219.      LISTER   PAS    - simple program to list your Pascal source
  220.      CMDLIN   PAS    - get parameters from the command line
  221.      DIRECT   PAS    - demonstrates TURBO directory procedures
  222.  
  223.      INTRPTCL DOC    - get the time from DOS
  224.      DOSFCALL DOC    - get the date from DOS
  225.      EXTERNAL DOC    - sample program using externals
  226.  
  227.      CALC     PAS    - sample spreadsheet program
  228.      CALC     HLP    - spreadsheet help file
  229.      CALCDEMO MCS    - spreadsheet data file (not for use with TURBO-87)
  230.      CALCMAIN PAS    - extra program for compiling spreadsheet if necessary
  231.                        (please see note inside CALCMAIN.PAS)
  232.  
  233.      IBM PC Implementation of TURBO only
  234.      -----------------------------------
  235.      TURTLE   PAS    - demonstrates Turtlegraphics
  236.      ART      PAS    - sample graphics program
  237.      COLOR    PAS    - sample color program
  238.      SOUND    PAS    - sample sound program
  239.      WINDOW   PAS    - demonstrates windowing
  240.  
  241.      Special versions of TURBO
  242.      -------------------------
  243.      These files will only be present on your disk if you have TURBO
  244.      with one (or both) of our extended real number packages.
  245.  
  246.      TURBO with 8087 Support
  247.      -----------------------
  248.      TURBO-87 COM    - TURBO PASCAL compiler with 8087 support
  249.      HILB     PAS    - demonstrates increased speed and precision of
  250.                        TURBO-87
  251.      TEST     PAS    - demonstrates increased speed and precision of
  252.                        TURBO-87
  253.  
  254.      TURBO with BCD Reals
  255.      --------------------
  256.      TURBOBCD COM    - TURBO PASCAL compiler with BCD reals
  257.      BCD      PAS    - demonstrates increased precision of TURBOBCD
  258.  
  259.      ---------------------------------------------------------------------
  260.