home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / enterprs / cpm / utils / s / tp3-read.doc < prev    next >
Encoding:
Text File  |  1992-12-08  |  16.0 KB  |  490 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.  In addition, a few  features have been
  7.     added since the manual went to print.
  8.  
  9.     This file contains all necessary corrections and  additions,  and
  10.     we apologize for any inconvenience this may cause you.
  11.  
  12.     Please make a working  copy of your TURBO disk and store the ori-
  13.     ginal in a safe  place.  For help  making a backup  copy,  please
  14.     refer to appendix M of the TURBO PASCAL Reference Manual.
  15.  
  16.     Now, using your working copy, run TINST to install TURBO.COM for
  17.     your terminal.  Installation procedures are discussed in  Chapter
  18.     One and Appendix L.
  19.  
  20.  
  21.               *******************************************
  22.               *                                         *
  23.               *   Need help  with TURBO?  Please  see   *
  24.               *   Appendix N in your Reference Manual   *
  25.               *   for answers to common questions.      *
  26.               *                                         *
  27.               *******************************************
  28.  
  29.  
  30.                          -------------------
  31.  
  32.  
  33.        Contents of the READ.ME File
  34.        ----------------------------
  35.     1. CORRECTIONS to the 3.0 Reference Manual        [ All versions ]
  36.     2. OMMISSIONS from the 3.0 Reference Manual       [ All versions ]
  37.     3. New FEATURES                                   [ CP/M-80      ]
  38.     4. ADDITIONAL FILE LIST                           [ CP/M-80      ]
  39.     5. READ.ME notes from the IBM PC implementation
  40.  
  41.  
  42.                          -------------------
  43.  
  44.  
  45.                              CORRECTIONS
  46.                              -----------
  47.  
  48.  
  49. Page 96 - Close
  50. ---------------
  51.      Notice TURBO 3.0  uses DOS' file handles;  it  is  therefore
  52.      ALWAYS  necessary to Close files,  even after  reading.  You
  53.      would otherwise quickly run out of file handles.
  54.  
  55.  
  56.  
  57. Page 102 - SkpEoln / SkpEof
  58. -----------------------------
  59.      The correct names for these functions are SeekEof and SeekEoln.
  60.  
  61.  
  62. Page 114 - BlockRead / BlockWrite
  63. ---------------------------------
  64.      In the PC-DOS/MS-DOS versions, the record size used in block
  65.      transfers may be specified by an optional Integer parameter.
  66.      on Reset or ReWrite, for example:
  67.  
  68.      var
  69.        InFile,
  70.        OutFile: File;
  71.  
  72.      begin
  73.        Assign(InFile,'INDATA');
  74.        Reset(InFile,RecSize);
  75.        Assign(OutFile,'OUTDATA');
  76.        ReWrite(OutFile,RecSize);
  77.        :
  78.        :
  79.  
  80.      where RecSize is an Integer expression.
  81.  
  82.  
  83. Page 162 - TextBackground
  84. -------------------------
  85.      Value must be between 0 and 7.
  86.  
  87.  
  88. Page 169 - Graphics Windows
  89. ---------------------------
  90.      When  you define a graphics window,  the coordinate (0,0) is
  91.      now  in  the upper left corner of the  WINDOW,  not  of  the
  92.      physical  screen.  This  changes  figure 19-2 on  page  170:
  93.      0,0  should be placed at the upper left corner of the window
  94.      (not of the screen).
  95.  
  96.  
  97. Page 174 - GetPoint
  98. -------------------
  99.      The correct name for this procedure is GetDotColor.
  100.  
  101.  
  102. Page 179 - Forward
  103. ------------------
  104.      The correct name for  this procedure  is FORWD (not  Forward
  105.      which  is  a reserved word).
  106.  
  107.  
  108. Page 182 -  TurtleWindow
  109. ------------------------
  110.      The  turtle does not stop at  the border of the  window. You
  111.      can  still  move  it outside of the window,  but  it  is not
  112.      shown.  Even with  PenDown,  it  will not  draw outside  the
  113.      window.
  114.  
  115.  
  116. Page 187 - On the Main Menu
  117. ---------------------------
  118.      The  implication that TURBO 3.0 will work with DOS  versions
  119.      earlier than 2.0 is an error. TURBO 3.0 REQUIRES DOS version
  120.      2.0 or later.
  121.  
  122.  
  123. Page 189 - ChDir
  124. ----------------
  125.      Will  also  log in a drive if used with a  drive  name,  for
  126.      example:
  127.  
  128.      ChDir('B:');
  129.  
  130.  
  131. Page 189 - GetDir
  132. -----------------
  133.      The integer parameter Dr refers to following:
  134.  
  135.        0 = logged drive
  136.        1 = A:
  137.        2 = B:
  138.        etc.
  139.  
  140.  
  141. Page 208 - Function Calls
  142. -------------------------
  143.      Two  of the definitions of RegPack on this page have SI  and
  144.      DI switched around. The correct definition is:
  145.  
  146.      type
  147.        RegPack  = record
  148.                     case Integer of
  149.                       1: (AX,BX,CX,DX,BP,SI,DI,DS,ES,Flags: Integer);
  150.                       2: (AL,AH,BL,BH,CL,CH,DL,DH         : Byte);
  151.                   end;
  152.  
  153.      In  addition,  the  type of  the parameters in the example  pro-
  154.      cedure Timer ought to be Integer, not Real.
  155.  
  156.  
  157. Page 253 - MOV AL,[BP-1]
  158. ------------------------
  159.      The correct statement is:  MOV AL,[BP+4]
  160.  
  161.  
  162. Page 293 - TURBO-BCD will compile and run any program
  163. -----------------------------------------------------
  164.      Well - almost. The Real functions Sin, Cos, ArcTan, Ln, Exp,
  165.      and Sqrt and the pre-declared constant Pi are not  available
  166.      in  TURBOBCD.
  167.  
  168.  
  169. Page 305 - SkpEoln / SkpEof
  170. -----------------------------
  171.      The correct names for these functions are SeekEof and SeekEoln.
  172.  
  173.  
  174. Page 309 - GetDot
  175. -----------------
  176.      The correct name for this procedure is GetDotColor.
  177.  
  178.  
  179. Page  317 - Number of Open Files
  180. --------------------------------
  181.      This  example is unfortunate,  because DOS can never  handle
  182.      more  than 16  files open concurrently,  regardless of  what
  183.      you specify in CONFIG.SYS.
  184.  
  185.  
  186. Page 325 - RUN-TIME ERROR MESSAGES
  187. ----------------------------------
  188.      Missing: F0 - Overlay file not found
  189.  
  190.  
  191. Page 327 - I/O ERROR MESSAGES
  192. -----------------------------
  193.      Missing: F3 - Too many open files (MS/PCDOS only)
  194.  
  195.  
  196.  
  197.                          -------------------
  198.  
  199.  
  200.                               OMISSIONS
  201.                               ---------
  202.  
  203.  
  204. TurtleDelay
  205. -----------
  206.      This  procedure can be used to slow down the turtle movement
  207.      to a speed which the eye can follow. The syntax is
  208.  
  209.        TurtleDelay(Ms);
  210.  
  211.      where  Ms  is  an integer expression  giving  the  delay  in
  212.      milliseconds  between each step of the turtle.  The  default
  213.      TurtleDelay is 0.
  214.  
  215.  
  216. User Written Error Handlers
  217. ---------------------------
  218.      In  Turbo Pascal 3.0 you may write your own error  handler,
  219.      which  is  called in case of an I/O or Run-time  error.  The
  220.      procedure must have the following header:
  221.  
  222.           procedure Error(ErrNo, ErrAddr: Integer);
  223.  
  224.      The  name of the  procedure  and its  parameters  are  unim-
  225.      portant,  as  long   as  it  is a procedure with  two  value
  226.      parameters  of  type Integer.
  227.  
  228.      The value passed in ErrNo is the error type and number.  The
  229.      most significant byte,  i.e. "Hi(ErrNo)", contains the error
  230.      type,  and  the least significant byte,   i.e.  "Lo(ErrNo)",
  231.      contains the error number (see Appendix F or G in the  Turbo
  232.      Pascal Manual).
  233.  
  234.      The following error types are defined:
  235.  
  236.           0   User Break (Ctrl-C).
  237.           1   I/O error.
  238.           2   Run-time error.
  239.  
  240.      In  case  of  a user interrupt (Ctrl-C),   the low  byte  of
  241.      "ErrNo" is always 1.  "ErrAddr" contains the address (offset
  242.      in Code Segment for 16 bit versions) of the error.
  243.  
  244.      To  activate the error handler,   assign its offset  address
  245.      to  the standard variable "ErrorPtr", i.e.
  246.  
  247.           ErrorPtr:=Ofs(Error);  [ 16 bit ]  or
  248.           ErrorPtr:=Addr(Error); [  8 bit ]
  249.  
  250.      There are no limits to what an error handler may  do.  Typi-
  251.      cally  it will close all open files,   output an error  mes-
  252.      sage, and call the Halt  standard procedure to terminate the
  253.      program.   If  an  error handler returns,   i.e.  if it does
  254.      not  call  Halt,   or  if an error occurs  within  an  error
  255.      handler,   Turbo Pascal will itself output the error message
  256.      and terminate the program.
  257.  
  258.  
  259.  
  260.  
  261.                          -------------------
  262.  
  263.  
  264.                 NEW FEATURES OF CP/M-80 IMPLEMENTATION OF
  265.                                 TURBO 3.0
  266.                              - AN OVERVIEW -
  267.                 -----------------------------------------
  268.  
  269. Inline
  270. ------
  271.      A constant identifier used in an INLINE statement does  not
  272.      always generate two bytes of code.
  273.  
  274. Files
  275. -----
  276.      New FIB formats.
  277.      Optional 4th parameter on Blockread/Write returns number of
  278.        blocks actually read.
  279.      SeekEoln function.
  280.      SeekEof function.
  281.  
  282.  
  283. Misc.
  284. -----
  285.      Exit procedure       -  To exit the current block
  286.      OvrDrive procedure   -  To specify the drive on which to find overlays
  287.      ParamCount function  -  Gives number of characters in the command buffer
  288.      ParamSk
  289.  function    -  Gives the string of characters in the command line
  290.  
  291. Overlays
  292. --------
  293.  
  294.      Overlay  files  are  opened and closed every time  they  are
  295.      accessed.  Therefore,  there is never a need to specifically
  296.      close  an  overlay file.
  297.  
  298.      The  Y compiler directive is no longer  supported.  Instead,
  299.      the   OvrPath (MS-DOS MESr OvrDrive (CP/M)  standard   proce-
  300.      dures   may  be  used to specify the drive and  subdirectory
  301.      in which overlay files reside.
  302.  
  303.      Please note that run-time error F0 indicates that your over-
  304.      lay file is missing or is called recursively.    (This error
  305.      number is omitted from the Reference  Manual but is included
  306.      elsewhere in this file.)
  307.  
  308.  
  309.                          -------------------
  310.  
  311.                        TURBO PASCAL Version 3.0
  312.                               CP/M-80
  313.                         Additional File List
  314.  
  315.      In addition to the list  of files  mentioned in  Chapter 1 of
  316.      your TURBO Reference Manual, the following files are included
  317.      on your TURBO disk:
  318.  
  319.      Sample programs
  320.      ---------------
  321.      LISTER   PAS    - simple program to list your Pascal source
  322.      CMDLIN   PAS    - get parameters from the command line
  323.  
  324.      CALC     PAS    - sample spreadsheet program
  325.      CALC     HLP    - spreadsheonlhelp file
  326.      CALCDEMO MCS    - spreadsheot data file (not for use with TURBO-87)
  327.      CALCMAIN PAS    - extra program for compiling spreadsheonlif necessary
  328.                        (please see note inside CALCMAIN.PAS)
  329.  
  330.      =====================================================================
  331.      NOTE:  The following section is the  READ.ME file  from the IBM PC
  332.             implementation of TURBO PASCAL 3.0 and is included here for
  333.             your information.
  334.      ---------------------------------------------------------------------
  335.  
  336.  
  337.                  GENERAL OVERVIEW OF NEW FEATURES OF TURBO 3.0
  338.                  ---------------------------------------------
  339.  
  340. A program that was written using TURBO 2.0 may behave differently
  341. using TURBO 3.0:
  342.  
  343.     - TURBO no longer does a ClrScr when your program first begins
  344.     - TURBO no longer does a GoToXY(1, 25) when your program terminates
  345.     - use of file handles now necessitates closing all files; you
  346.       should also place a "FILES =" statement in your CONFIG.SYS file
  347.       (please consult your DOS reference manual for more information).
  348.     - a read statement using the logical device TRM is terminated with a
  349.       <CR>.
  350.  
  351. TINST Installation
  352. ------------------
  353.  
  354.      TINST now allows you to install a pathname which is used by TURBO
  355.      when loading the error message file (TURBO.MSG).
  356.  
  357.      In the screen installation, after choosing your display type, the
  358.      following question will appear:
  359.  
  360.         Does your screen blink when the text scrolls? (Y/N):
  361.  
  362.      If the screen is "snowy" in the TURBO editor,  answer "Y" to
  363.      this question.
  364.  
  365.  
  366. Chain and Execute
  367. -----------------
  368.      Heap preserved during Chain (MS/PC-DOS & CP/M-86).
  369.  
  370.      Chain  and Execute no longer set a flag in the command  line
  371.      parameter.
  372.  
  373.  
  374. Inline
  375. ------
  376.      A constant identifier used in a INLINE statement does  not
  377.      always generate two bytes of code.
  378.  
  379. Files
  380. -----
  381.      Append procedure (MS/PC-DOS .
  382.      Full DOS path-name supported (MS/PC-DOS .
  383.      I/O re-direction (MS/PC-DOS .
  384.      New FIB formats.
  385.      Optional parameter on text file declaration sets buffer size
  386.      (MS/PC-DOS & CP/M-86).
  387.      Optional  parameter  on Reset/ReWrite sets (0d  size  for
  388.      untyped files (MS/PC-DOS .
  389.      Optional 4th parameter on Blockread/Write sets block size.
  390.      Read and ReadLn work with array of char (MS/PC-DOS & CP/M-86).
  391.      Seek procedure may take Real argument (MS/PC-DOS .
  392.      SeekEoln function.
  393.      SeekEof function.
  394.      Truncate procedure (MS/PC-DOS .
  395.  
  396.  
  397. Misc.
  398. -----
  399.      ChDir procedure (MS/PC-DOS .
  400.      Command line parameters on Options menu (MS/PC-DOS and CP/M-86).
  401.      Delay procedure independent of processor speed (PC-DOS .
  402.      Exit procedure.
  403.      Extended  graphics procedures & functions  (see page 309  in
  404.      manual for overview).
  405.      GetDir procedure (MS/PC-DOS .
  406.      MkDir procedure (MS/PC-DOS .
  407.      Multiple EXTERNAL subprograms in one file (MS/PC-DOS & CP/M-86).
  408.      Optional parameter on Halt to return error code (PC/MS-DOS).
  409.      Ove moath procedure (MS/PC-DOS .
  410.      OvrDrive procedure (CP/M).
  411.      ParamCount function.
  412.      ParamSkr function.
  413.      RmDir procedure (MS/PC-DOS .
  414.      Runs overlays in Memory mode (MS/PC-DOS & CP/M-86)
  415.      Turtlegraphics  procedures,  functions,  and constants  (see
  416.      page 309-310 in manual for overview).
  417.  
  418.  
  419. Overlays
  420. --------
  421.      Overlays can be run in Memory mode (MS/PC-DOS & CP/M-86).
  422.  
  423.      Overlay  files  are  opened abetwlosed every time  they  are
  424.      accessed.  Therefore,  there is never a need to specifically
  425.      close  an  overlay file.
  426.  
  427.      The  Y compiler directive is no longer  supported.  Instead,
  428.      the   OvrPath (MS-DOS MESr OvrDrive (CP/M)  standard   proce-
  429.      dures   may  be  used to specify the drive and  subdirectory
  430.      in which overlay files reside.
  431.  
  432.  
  433.  
  434.  
  435.                          -------------------
  436.  
  437.                        TURBO PASCAL Version 3.0
  438.  
  439.                         Additional File List
  440.  
  441.      In addition to the list  of files  mentioned in  Chapter 1 of
  442.      your TURBO Reference Manual, the following files are included
  443.      on your TURBO disk:
  444.  
  445.      ACCESS3  BOX    - for TOOLBOX users only: ACCESS.BOX update
  446.  
  447.      Sample programs
  448.      ---------------
  449.      LISTER   PAS    - simple program to list your Pascal source
  450.      TURTLE   PAS    - demonstrates Turtlegraphics
  451.      CMDLIN   PAS    - get parameters from the command line
  452.      DIRECT   PAS    - demonstrates TURBO directory procedures
  453.  
  454.      ART      PAS    - sample graphics program
  455.      COLOR    PAS    - sample color program
  456.      SOUND    PAS    - sample sound program
  457.      WINDOW   PAS    - demonstrates windowing
  458.  
  459.      INTRPTCL DOC    - get the time from DOS
  460.      DOSFCALL DOC    - get the date from DOS
  461.      EXTERNAL DOC    - sample program using externals
  462.  
  463.      CALC     PAS    - sample spreadsheot program
  464.      CALC     HLP    - spreadsheot help file
  465.      CALCDEMO MCS    - spreadsheot data file (not for use with TURBO-87)
  466.      CALCMAIN PAS    - extra program for compiling spreadsheot if necessary
  467.                        (please see note inside CALCMAIN.PAS)
  468.  
  469.  
  470.      Special versions of TURBO
  471.      -------------------------
  472.      These files will only be present on your disk if you have TURBO
  473.      with one (or both MESf our extended real number packages.
  474.  
  475.      TURBO with 8087 Support
  476.      -----------------------
  477.      TURBO-87 COM    - TURBO PASCAL compiler with 8087 support
  478.      HILB     PAS    - demonstrates increased speed and precision of
  479.                        TURBO-87
  480.      TEST     PAS    - demonstrates increased speed and precision of
  481.                        TURBO-87
  482.  
  483.      TURBO with BCD Reals
  484.      --------------------
  485.      TURBOBCD COM    - TURBO PASCAL compiler with BCD reals
  486.      BCD      PAS    - demonstrates increased precision of TURBOBCD
  487.  
  488.      ---------------------------------------------------------------------
  489.      NOTE:  The above applies to IBM PC and true compatibles only
  490.