home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 9 / 09.iso / l / l039 / 1.img / READ.ME < prev    next >
Encoding:
Text File  |  1985-03-21  |  12.8 KB  |  377 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.     At  the  end  of  this file, you will find a summary  of the  new
  13.     features  introduced in TURBO 3.0 and a  list of additional files
  14.     present on your TURBO disk.
  15.  
  16.  
  17.               *******************************************
  18.               *                                         *
  19.               *   Need help  with TURBO?  Please  see   *
  20.               *   Appendix N in your Reference Manual   *
  21.               *   for answers to common questions.      *
  22.               *                                         *
  23.               *******************************************
  24.  
  25.  
  26.                          -------------------
  27.  
  28.  
  29.                              CORRECTIONS
  30.                           0 0-│M▓@ç_(Cºñ        ██╥Θ÷ü;@ Næ.@ùñ    ┌Φ░ @╕Nü@4
  31.     Ç ƒíºΦKÇΦ&áD>(RºçΓ cττ└'╠╚$'─A─'┴╟D└─ 'τ┴ττ┴'τ└┴─D@D88gττττ╧└'τ└DA'└└'╬└'─A─ ττ─Dg╟@─gτ┬D┴D gτ┴88gττττ└─τ└┴─@'├┴'┬@g└τ└g─A─'┴╟D└─ x8x8x8x8C╟'π#Γgα'┬╠└gα'┬╠x8`                            88gττττ└┴─'╞BDτ└G'─@g└┴─'─@F┴B'╟D'┬ g╟Dτ┬ └`x8x8xe 114 - BlockRead / BlockWrite
  32. ---------------------------------
  33.      In the PC-DOS/MS-DOS versions, the record size used in block
  34.      transfers may be specified by an optional Integer parameter.
  35.      on Reset or ReWrite, for example:
  36.  
  37.      var
  38.        InFile,
  39.        OutFile: File;
  40.  
  41.      begin
  42.        Assign(InFile,'INDATA');
  43.        Reset(InFile,RecSize);
  44.        Assign(OutFile,'OUTDATA');
  45.        ReWrite(OutFile,RecSize);
  46.        :
  47.        :
  48.  
  49.      where RecSize is an Integer expression.
  50.  
  51.  
  52. Page 162 - TextBackground
  53. -------------------------
  54.      Value must be between 0 and 7.
  55.  
  56.  
  57. Page 169 - Graphics Windows
  58. ---------------------------
  59.      When  you define a graphics window,  the coordinate (0,0) is
  60.      now  in  the upper left corner of the  WINDOW,  not  of  the
  61.      physical  screen.  This  changes  figure 19-2 on  page  170:
  62.      0,0  should be placed at the upper left corner of the window
  63.      (not of the screen).
  64.  
  65.  
  66. Page 174 - GetPoint
  67. -------------------
  68.      The correct name for this procedure is GetDotColor.
  69.  
  70.  
  71. Page 179 - Forward
  72. ------------------
  73.      The correct name for  this procedure  is FORWD (not  Forward
  74.      which  is  a reserved word).
  75.  
  76.  
  77. Page 182 -  TurtleWindow
  78. ------------------------
  79.      The  turtle does not stop at  the border of the  window. You
  80.      can  still  move  it outside of the window,  but  it  is not
  81.      shown.  Even with  PenDown,  it  will not  draw outside  the
  82.      window.
  83.  
  84.  
  85. Page 187 - On the Main Menu
  86. ---------------------------
  87.      The  implication that TURBO 3.0 will work with DOS  versions
  88.      earlier than 2.0 is an error. TURBO 3.0 REQUIRES DOS version
  89.      2.0 or later.
  90.  
  91.  
  92. Page 189 - ChDir
  93. ----------------
  94.      Will  also  log in a drive if used with a  drive  name,  for
  95.      example:
  96.  
  97.      ChDir('B:');
  98.  
  99.  
  100. Page 189 - GetDir
  101. -----------------
  102.      The integer parameter Dr refers to following:
  103.  
  104.        0 = logged drive
  105.        1 = A:
  106.        2 = B:
  107.        etc.
  108.  
  109.  
  110. Page 208 - Function Calls
  111. -------------------------
  112.      Two  of the definitions of RegPack on this page have SI  and
  113.      DI switched around. The correct definition is:
  114.  
  115.      type
  116.        RegPack  = record
  117.                     case Integer of
  118.                       1: (AX,BX,CX,DX,BP,SI,DI,DS,ES,Flags: Integer);
  119.                       2: (AL,AH,BL,BH,CL,CH,DL,DH         : Byte);
  120.                   end;
  121.  
  122.      In  addition,  the  type of  the parameters in the example  pro-
  123.      cedure Timer ought to be Integer, not Real.
  124.  
  125.  
  126. Page 253 - MOV AL,[BP-1]
  127. ------------------------
  128.      The correct statement is:  MOV AL,[BP+4]
  129.  
  130.  
  131. Page 293 - TURBO-BCD will compile and run any program
  132. -----------------------------------------------------
  133.      Well - almost. The Real functions Sin, Cos, ArcTan, Ln, Exp,
  134.      and Sqrt and the pre-declared constant Pi are not  available
  135.      in  TURBOBCD.
  136.  
  137.  
  138. Page 305 - SkpEoln / SkpEof
  139. -----------------------------
  140.      The correct names for these functions are SeekEof and SeekEoln.
  141.  
  142.  
  143. Page 309 - GetDot
  144. -----------------
  145.      The correct name for this procedure is GetDotColor.
  146.  
  147.  
  148. Page  317 - Number of Open Files
  149. --------------------------------
  150.      This  example is unfortunate,  because DOS can never  handle
  151.      more  than 16  files open concurrently,  regardless of  what
  152.      you specify in CONFIG.SYS.
  153.  
  154.  
  155. Page 325 - RUN-TIME ERROR MESSAGES
  156. ----------------------------------
  157.      Missing: F0 - Overlay file not found
  158.  
  159.  
  160. Page 327 - I/O ERROR MESSAGES
  161. -----------------------------
  162.      Missing: F3 - Too many open files (MS/PCDOS only)
  163.  
  164.  
  165.  
  166.                          -------------------
  167.  
  168.  
  169.                               OMISSIONS
  170.                               ---------
  171.  
  172.  
  173. TurtleDelay
  174. -----------
  175.      This  procedure can be used to slow down the turtle movement
  176.      to a speed which the eye can follow. The syntax is
  177.  
  178.        TurtleDelay(Ms);
  179.  
  180.      where  Ms  is  an integer expression  giving  the  delay  in
  181.      milliseconds  between each step of the turtle.  The  default
  182.      TurtleDelay is 0.
  183.  
  184.  
  185. User Written Error Handlers
  186. ---------------------------
  187.      In  Turbo Pascal 3.00 you may write your own error  handler,
  188.      which  is  called in case of an I/O or Run-time  error.  The
  189.      procedure must have the following header:
  190.  
  191.           procedure Error(ErrNo, ErrAddr: Integer);
  192.  
  193.      The  name of the  procedure  and its  parameters  are  unim-
  194.      portant,  as  long   as  it  is a procedure with  two  value
  195.      parameters  of  type Integer.
  196.  
  197.      The value passed in ErrNo is the error type and number.  The
  198.      most significant byte,  i.e. "Hi(ErrNo)", contains the error
  199.      type,  and  the least significant byte,   i.e.  "Lo(ErrNo)",
  200.      contains the error number (see Appendix F or G in the  Turbo
  201.      Pascal Manual).
  202.  
  203.      The following error types are defined:
  204.  
  205.           0   User Break (Ctrl-C).
  206.           1   I/O error.
  207.           2   Run-time error.
  208.  
  209.      In  case  of  a user interrupt (Ctrl-C),   the low  byte  of
  210.      "ErrNo" is always 1.  "ErrAddr" contains the address (offset
  211.      in Code Segment for 16 bit versions) of the error.
  212.  
  213.      To  activate the error handler,   assign its offset  address
  214.      to  the standard variable "ErrorPtr", i.e.
  215.  
  216.           ErrorPtr:=Ofs(Error);  { 16 bit }  or
  217.           ErrorPtr:=Addr(Error); {  8 bit }
  218.  
  219.      There are no limits to what an error handler may  do.  Typi-
  220.      cally  it will close all open files,   output an error  mes-
  221.      sage, and call the Halt  standard procedure to terminate the
  222.      program.   If  an  error handler returns,   i.e.  if it does
  223.      not  call  Halt,   or  if an error occurs  within  an  error
  224.      handler,   Turbo Pascal will itself output the error message
  225.      and terminate the program.
  226.  
  227.  
  228.  
  229.  
  230.                          -------------------
  231.  
  232.  
  233.                 OVERVIEW OF NEW FEATURES OF TURBO 3.0
  234.                 -------------------------------------
  235.  
  236. A program that was written using TURBO 2.0 may behave differently
  237. using TURBO 3.0:
  238.  
  239.     - TURBO no longer does a ClrScr when your program first begins
  240.     - TURBO no longer does a GoToXY(1, 25) when your program terminates
  241.     - use of file handles now necessitates closing all files; you
  242.       should also place a "FILES =" statement in your CONFIG.SYS file
  243.       (please consult your DOS reference manual for more information).
  244.     - a read statement using the logical device TRM is terminated with a
  245.       <CR>.
  246.  
  247. TINST Installation
  248. ------------------
  249.  
  250.      TINST now allows you to install a pathname which is used by TURBO
  251.      when loading the error message file (TURBO.MSG).
  252.  
  253.      IBM PC Implementation only
  254.      --------------------------
  255.         In the screen installation, after choosing your display type, the
  256.         following question will appear:
  257.  
  258.            Does your screen blink when the text scrolls? (Y/N):
  259.  
  260.         If the screen is "snowy" in the TURBO editor,  answer "Y" to
  261.         this question.
  262.  
  263.  
  264. Chain and Execute
  265. -----------------
  266.      Heap preserved during Chain (MS/PC-DOS & CP/M-86).
  267.  
  268.      Chain  and Execute no longer set a flag in the command  line
  269.      parameter.
  270.  
  271.  
  272. Inline
  273. ------
  274.      A constant identifier used in an INLINE statement does  not
  275.      always generate two bytes of code.
  276.  
  277. Files
  278. -----
  279.      Append procedure (MS/PC-DOS).
  280.      Full DOS path-name supported (MS/PC-DOS).
  281.      I/O re-direction (MS/PC-DOS).
  282.      New FIB formats.
  283.      Optional parameter on text file declaration sets buffer size
  284.      (MS/PC-DOS & CP/M-86).
  285.      Optional  parameter  on Reset/ReWrite sets record  size  for
  286.      untyped files (MS/PC-DOS).
  287.      Optional 4th parameter on Blockread/Write sets block size.
  288.      Read and ReadLn work with array of char (MS/PC-DOS & CP/M-86).
  289.      Seek procedure may take Real argument (MS/PC-DOS).
  290.      SeekEoln function.
  291.      SeekEof function.
  292.      Truncate procedure (MS/PC-DOS).
  293.  
  294.  
  295. Misc.
  296. -----
  297.      ChDir procedure (MS/PC-DOS).
  298.      Command line parameters on Options menu (MS/PC-DOS and CP/M-86).
  299.      Delay procedure independent of processor speed (PC-DOS).
  300.      Exit procedure.
  301.      Extended  graphics procedures & functions  (see page 309  in
  302.      manual for overview).
  303.      GetDir procedure (MS/PC-DOS).
  304.      MkDir procedure (MS/PC-DOS).
  305.      Multiple EXTERNAL subprograms in one file (MS/PC-DOS & CP/M-86).
  306.      Optional parameter on Halt to return error code (PC/MS-DOS).
  307.      OvrPath procedure (MS/PC-DOS).
  308.      OvrDrive procedure (CP/M).
  309.      ParamCount function.
  310.      ParamStr function.
  311.      RmDir procedure (MS/PC-DOS).
  312.      Runs overlays in Memory mode (MS/PC-DOS & CP/M-86)
  313.      Turtlegraphics  procedures,  functions,  and constants  (see
  314.      page 309-310 in man}al foz ε÷e╗φ²φ╔φφφφφφφφφφφφφφφφφφφφφφφφφφεq╬1 |ZΣ╚┬≥µ@╞┬∞@─╩@ΣΩ▄@╥▄@Ü╩┌▐Σ≥@┌▐╚╩@Pܪ^áåZê₧ª@L@åá^ÜZplR\@@@@@₧∞╩Σ╪┬≥@@╠╥╪╩µ@@┬Σ╩@@▐α╩▄╩╚@┬▄╚@╞╪▐µ╩╚@╩∞╩Σ≥@Φ╥┌╩@@Φ╨╩≥@@┬Σ╩@@@@@┬╞╞╩µµ╩╚\@@¿╨╩Σ╩╠▐Σ╩X@@Φ╨╩Σ╩@╥µ@▄╩∞╩Σ@┬@▄╩╩╚@Φ▐@µα╩╞╥╠╥╞┬╪╪≥@@@@@╞╪▐µ╩@@┬▄@@▐∞╩Σ╪┬≥@╠╥╪╩\@@@@@¿╨╩@@▓@╞▐┌α╥╪╩Σ@╚╥Σ╩╞Φ╥∞╩@╥µ@▄▐@╪▐▄╬╩Σ@@µΩαα▐ΣΦ╩╚\@@Æ▄µΦ╩┬╚X@@@@@Φ╨╩@@@₧∞Σá┬Φ╨@PܪZê₧ªR@▐Σ@₧∞ΣêΣ╥∞╩@(CP/M)  standard   proce-
  315.      dures   may  be  used to specify the drive and  subdirectory
  316.      in which overlay files reside.
  317.  
  318.  
  319.  
  320.  
  321.                          -------------------
  322.  
  323.                       TURBO PASCAL Version 3.0
  324.  
  325.                         Additional File List
  326.  
  327.      In addition to the list  of files  mentioned in  Chapter 1 of
  328.      your TURBO Reference Manual, the following files are included
  329.      on your TURBO disk:
  330.  
  331.      ACCESS3  BOX    - for TOOLBOX users only: ACCESS.BOX update
  332.  
  333.      Sample programs
  334.      ---------------
  335.      LISTER   PAS    - simple program to list your Pascal source
  336.      CMDLIN   PAS    - get parameters from the command line
  337.      DIRECT   PAS    - demonstrates TURBO directory procedures
  338.  
  339.  
  340.      INTRPTCL DOC    - get the time from DOS
  341.      DOSFCALL DOC    - get the date from DOS
  342.      EXTERNAL DOC    - sample program using externals
  343.  
  344.      CALC     PAS    - sample spreadsheet program
  345.      CALC     HLP    - spreadsheet help file
  346.      CALCDEMO MCS    - spreadsheet data file (not for use with TURBO-87)
  347.      CALCMAIN PAS    - extra program for compiling spreadsheet if necessary
  348.                        (please see note inside CALCMAIN.PAS)
  349.  
  350.      IBM PC Implementation of TURBO only
  351.      -----------------------------------
  352.      TURTLE   PAS    - demonstrates Turtlegraphics
  353.      ART      PAS    - sample graphics program
  354.      COLOR    PAS    - sample color program
  355.      SOUND    PAS    - sample sound program
  356.      WINDOW   PAS    - demonstrates windowing
  357.  
  358.      Special versions of TURBO
  359.      -------------------------
  360.      These files will only be present on your disk if you have TURBO
  361.      with one (or both) of our extended real number packages.
  362.  
  363.      TURBO with 8087 Support
  364.      -----------------------
  365.      TURBO-87 COM    - TURBO PASCAL compiler with 8087 support
  366.      HILB     PAS    - demonstrates increased speed and precision of
  367.                        TURBO-87
  368.      TEST     PAS    - demonstrates increased speed and precision of
  369.                        TURBO-87
  370.  
  371.      TURBO with BCD Reals
  372.      --------------------
  373.      TURBOBCD COM    - TURBO PASCAL compiler with BCD reals
  374.      BCD      PAS    - demonstrates increased precision of TURBOBCD
  375.  
  376.      ---------------------------------------------------------------------
  377.