home *** CD-ROM | disk | FTP | other *** search
/ The Devil's Doorknob BBS Capture (1996-2003) / devilsdoorknobbbscapture1996-2003.iso / Dloads / OTHERUTI / TPASCAL1.ZIP / README < prev    next >
Text File  |  1991-06-11  |  16KB  |  407 lines
  1.                      WELCOME TO TURBO PASCAL 6.0
  2.                      ---------------------------
  3.  
  4. This README file contains important, last minute information about
  5. Turbo Pascal 6.0. In addition to this file, there are several .DOC
  6. files in the \TP\DOC directory that you should browse. The HELPME!.DOC
  7. file answers many common Technical Support questions. The FIXES.DOC
  8. file provides corrections to the printed documentation. And the
  9. TVISION.DOC file gives additional information (reference and tutorial)
  10. about programming in Turbo Vision.
  11.  
  12.  
  13. TABLE OF CONTENTS
  14. -----------------
  15.  1.  How to Get Help
  16.  2.  Installation
  17.  3.  Take a Tour
  18.  4.  Turbo Help
  19.  5.  New Features
  20.  6.  Turbo Vision Examples
  21.  7.  Important Documentation Information
  22.  8.  Compatibility Notes
  23.  9.  Testing Expanded Memory
  24. 10.  Complete List of Files
  25.  
  26.  
  27.  1. HOW TO GET HELP
  28. -------------------
  29. If you have any problems, please read this file, the *.DOC files in
  30. \TP\DOC, and the Turbo Pascal manuals first. If you still have a
  31. question and need assistance, help is available from the following
  32. sources:
  33.  
  34. 1. Type GO BPROGA on the CompuServe bulletin board system. If you are
  35.    not a member of CompuServe, see the enclosed special offer.
  36.  
  37. 2. Check with your software dealer or user group.
  38.  
  39. 3. Write to us:
  40.  
  41.    Borland International
  42.    Turbo Pascal 6.0 Technical Support
  43.    1800 Green Hills Road
  44.    P.O. Box 660001
  45.    Scotts Valley, CA  95067-0001
  46.  
  47.    Please include your serial number or we will be unable to process
  48.    your letter.
  49.  
  50. 4. If you have an urgent problem and you have sent in the license
  51.    agreement that accompanied this package, you may call the Borland
  52.    Technical Support Department at (408) 438-5300. Please have the
  53.    following information ready before calling:
  54.  
  55.    a. Product name and serial number from the distribution disks.
  56.  
  57.    b. Product version number. Both the IDE and the command-line
  58.       compiler display a version number when they are executed.
  59.  
  60.    c. Computer brand, model, and the brands and model numbers of
  61.       any additional hardware.
  62.  
  63.    d. Operating system and version number. (The version number can
  64.       be determined by typing VER at the DOS prompt.)
  65.  
  66.    e. Contents of your AUTOEXEC.BAT and CONFIG.SYS files.
  67.  
  68.  
  69. 2. INSTALLATION
  70. ---------------
  71. Use the INSTALL program to install Turbo Pascal. The files on the
  72. distribution disks are all archived and INSTALL will de-archive them
  73. for you. INSTALL will place them into subdirectories and automatically
  74. create configuration files for both the command-line compiler and the
  75. Integrated Development Environment (IDE). All further references to
  76. directory paths in this README file assume you've used INSTALL's
  77. default directory structure.
  78.  
  79. To start the installation, place the disk labeled INSTALL in Drive A:,
  80. change to Drive A: and type A:INSTALL.
  81.  
  82.   A:
  83.   INSTALL
  84.  
  85. INSTALL works on both hard disk and dual-floppy systems. If you decide
  86. to de-archive files manually, just run the UNZIP program (found on the
  87. INSTALLATION disk) on any .ZIP file. For example, to de-archive
  88. TPC.EXE and TURBO.TPL from the TURBO.ZIP file on Drive A:, type:
  89.  
  90.   unzip a:turbo turbo.tpl tpc.exe
  91.  
  92. This places TURBO.TPL and TPC.EXE onto the current drive or directory
  93. (and assumes UNZIP.EXE is already in the current drive or directory).
  94.  
  95.  
  96. 3. TAKE A TOUR
  97. --------------
  98. Take an online tour of the new Integrated Development Environment. Run
  99. TPTOUR from the \TP directory for a 10-minute introduction to editing,
  100. compiling and running programs in the new IDE.
  101.  
  102.  
  103. 4. TURBO HELP
  104. -------------
  105. The fastest way to get help on any Turbo Pascal feature is to use the
  106. newly expanded online help system. Pull down the Help menu by typing
  107. Alt-H and then browse topics (via the Contents menu) or lookup
  108. identifiers (by selecting Topic search). If it's in Turbo Pascal, it's
  109. in the help system! And if you use the command-line compiler and your
  110. own editor, you can still get Turbo Help using THELP.COM. THELP is a
  111. TSR that can be found in the \TP\UTILS directory.
  112.  
  113.  
  114. 5. NEW FEATURES
  115. ---------------
  116. Turbo Pascal 6.0 offers many new features, including:
  117.  
  118. o Borland's new Integrated Developer's Environment (IDE), our new
  119.   generation user interface that includes all the features you're used
  120.   to, plus:
  121.  
  122.   o Mouse support.
  123.   o Multiple overlapping windows.
  124.   o Multi-file editor that can edit files up to 1 mbyte in size.
  125.   o Cut, copy and paste using the Clipboard.
  126.   o Turbo online help system that has been expanded, with
  127.     copy-and-paste program examples for practically every function.
  128.     Includes full reference to Turbo Vision objects, methods,
  129.     variables and constants.
  130.   o Conditional breakpoints.
  131.   o CPU Register window.
  132.   o Makes full use of EMS to enhance performance and increase
  133.     capacity.
  134.   o Built-in customization for color and startup options.
  135.  
  136. o Turbo Vision, an object-oriented, high-performance application
  137.   framework and library. Programs written in Turbo Vision inherit
  138.   everything from mouse support, dialogs, menus, overlapping windows,
  139.   and automatic desktop management to the online help system,
  140.   calculator, and other tools that you'll find in the \TP\TVDEMOS
  141.   directory.
  142.  
  143.   Programming with Turbo Vision is so efficient and powerful, we used
  144.   it to build the IDE itself!
  145.  
  146. o Built-in, inline assembler. Combine the best of both worlds: write
  147.   assembly language instructions inside your Turbo Pascal programs.
  148.  
  149. o Private fields and methods are now supported in an object
  150.   declaration. This enables you to "enforce" encapsulation. Object
  151.   privacy is implemented consistently with the existing data hiding
  152.   capabilities of a unit. See P-87 in the User's Guide and P-35 in the
  153.   Programmer's Guide for more information.
  154.  
  155. o Other enhancements include:
  156.   o New Objects unit with better collections and streams.
  157.   o New heap manager is faster and safer.
  158.   o Extended syntax compiler directive {$X} allows you to
  159.     optionally discard function results.
  160.   o New procedure directives: far, near and assembler.
  161.   o 80286 code generation directive {$G}.
  162.   o Minor code generation improvements.
  163.   o Address references in typed constant pointers.
  164.   o Link in initialized data from .OBJs {$L}.
  165.  
  166.  
  167. 6. TURBO VISION EXAMPLES
  168. ------------------------
  169. There are three different kinds of Turbo Vision example programs
  170. provided. You'll find all the example programs from the Turbo Vision
  171. Guide in the \TP\DOCDEMOS directory. You'll find several Turbo Vision
  172. application support units in the \TP\TVISION directory. And you'll
  173. find several Turbo Vision demonstration programs in the \TP\TVDEMOS
  174. directory.
  175.  
  176. If you're trying to run one of the Turbo Vision demos from inside the
  177. IDE, we recommend that you set Compile|Destination to disk and the
  178. Link Buffer option to Disk (in the Options|Linker dialog box). Many of
  179. these examples are large programs and require full memory capacity to
  180. compile and run. Depending on your system configuration, you may need
  181. to compile and run them from DOS. Here's how to use the command-line
  182. compiler on TVDEMO.PAS:
  183.  
  184.   cd \tp\tvdemos
  185.   tpc /m tvdemos
  186.  
  187. Then run TVDEMO.PAS from DOS by typing:
  188.  
  189.   tvdemo
  190.  
  191. In order to facilitate compiling these demos on a wide variety of
  192. system configurations, we've turned off debug information {$D-} in all
  193. Turbo Vision units. If you have a system with lots of memory and EMS,
  194. you might want to enable the {$D} compiler directive in selected units
  195. in \TP\TVDEMOS so you can step through the code.
  196.  
  197.  
  198. 7. IMPORTANT DOCUMENTATION INFORMATION
  199. --------------------------------------
  200. All source code examples from the Turbo Vision Guide and from the
  201. User's Guide's chapter on object-oriented programming (chapter 4) can
  202. be found in the \TP\DOCDEMOS directory.
  203.  
  204.  
  205. 8.  Compatibility notes
  206. -----------------------
  207.  
  208. Turbo Debugger and Turbo Pascal 6.0
  209. --------------------------------------
  210. You can use any version of Turbo Debugger with Turbo Pascal 6.0.
  211. However, because of the changes to the heap manager, don't watch,
  212. inspect or evaluate MemAvail or MaxAvail unless you're using Turbo
  213. Debugger 2.01 or later.
  214.  
  215.  
  216. Turbo Pascal 6.0 Heap Manager
  217. -----------------------------
  218. The new heap manager is faster and more efficient than in Turbo Pascal
  219. 5.x. FreeMin is no longer needed and you can simply delete all
  220. references to it in your programs. FreePtr has been replaced. If
  221. you're relying on implementation-dependent features of the old heap
  222. manager, you'll have to modify your code to eliminate references to
  223. FreePtr. (If you just need to compress the heap, you can call the
  224. SetMemTop procedure from the Turbo Vision Memory unit.) See Chapter 16
  225. in the Programmer's Guide for more information about how the new heap
  226. manager works.
  227.  
  228. If you are using a HeapError function, make sure it exits quickly when
  229. passed a Size value of 0:
  230.  
  231.   function HeapError(Size: Word): Integer; far;
  232.   begin
  233.     if Size > 0 then
  234.     begin
  235.       { ... perform HeapError processing here ... }
  236.     end;
  237.   end;
  238.  
  239. In version 6.0, HeapError is called with a value of 0 whenever an
  240. allocation moves the HeapPtr upwards.
  241.  
  242.  
  243. Turbo Pascal 6.0 and the Toolboxes
  244. ----------------------------------
  245. The 4.0 toolboxes all work with Turbo Pascal 6.0. (The Turbo Editor
  246. Toolbox needs 2 easy source code modifications to work with 6.0. See
  247. the file HELPME!.DOC in \TP\DOC for more information.)
  248.  
  249.  
  250. Turbo Pascal 5.5 Object Unit
  251. ----------------------------
  252. All the demo units and programs from Turbo Pascal 5.5 will work with
  253. version 6.0 if you recompile them. However, we recommend that you use
  254. the new Object unit's streams and collections in any new programs you
  255. write. Note that you cannot use the 5.5 Objects unit with Turbo
  256. Vision.
  257.  
  258.  
  259. 9. Testing Expanded Memory: EMSTEST.COM
  260. ---------------------------------------
  261. EMSTEST.COM is in the \TP\UTILS directory and can be used to test your
  262. Expanded Memory (EMS) hardware and software. If you have problems
  263. using Turbo Pascal with your EMS, type EMSTEST at the DOS prompt and
  264. follow the instructions. (To disable the IDE's EMS usage, specify /X-
  265. on the commandline when you load TURBO. To determine how much EMS the
  266. IDE is using, load TURBO and select GET INFO on the FILE menu.)
  267.  
  268.  
  269. 10. Complete List of Files
  270. --------------------------
  271. The INSTALL program will place all of the following on your hard disk
  272. during the installation process (the floppy installation installs only
  273. TURBO.TPL and TURBO.EXE or TPC.EXE):
  274.  
  275.   Install/Compiler
  276.   ----------------
  277.   INSTALL.EXE    - Installs Turbo Pascal on your system
  278.   README.COM     - Program to display README file
  279.   UNZIP.EXE      - De-archiving program
  280.   TURBO.ZIP      - Archived file containing:
  281.     TURBO.EXE    - Turbo Pascal Integrated Development Environment
  282.     TURBO.TPL    - Resident units for Turbo Pascal
  283.     TURBO.TP     - Configuration file for TURBO.EXE
  284.     TPC.EXE      - Command-line version of Turbo Pascal
  285.   README         - This file!
  286.  
  287.   Turbo Vision/Tour
  288.   -----------------
  289.   TVISION.ZIP    - Archived file containing Turbo Vision units:
  290.     APP.PAS      - Application unit source
  291.     BUFFERS.PAS  - Buffers unit source
  292.     COLORSEL.PAS - Color installation unit source
  293.     EDITORS.PAS  - Editors unit source
  294.     MSGBOX.PAS   - Message box unit source
  295.     STDDLG.PAS   - Standard dialogs unit source
  296.     APP.TPU      - Application unit
  297.     BUFFERS.TPU  - Buffers unit
  298.     COLORSEL.TPU - Color installation unit
  299.     DIALOGS.TPU  - Dialogs unit
  300.     DRIVERS.TPU  - Drivers unit
  301.     EDITORS.TPU  - Editors unit
  302.     HISTLIST.TPU - History list unit
  303.     MEMORY.TPU   - Memory management unit
  304.     MENUS.TPU    - Menus unit
  305.     MSGBOX.TPU   - Messagebox unit
  306.     OBJECTS.TPU  - Objects unit
  307.     STDDLG.TPU   - Standard dialogs unit
  308.     TEXTVIEW.TPU - Simple text window unit
  309.     VIEWS.TPU    - Views unit
  310.  
  311.   TVDEMOS.ZIP    - Archived file containing Turbo Vision demos:
  312.     TVDEMO.PAS   - Turbo Vision demo application
  313.     DEMOHELP.HLP - Compiled help file for TVDEMO
  314.     ASCIITAB.PAS - ASCII table viewer
  315.     CALC.PAS     - Desktop calculator
  316.     CALENDAR.PAS - Desktop calendar (monthly viewer)
  317.     DEMOHELP.PAS - Context file produced by running HC on DEMOHELP.TXT
  318.     FVIEWER.PAS  - Text file viewer
  319.     GADGETS.PAS  - Desktop gadgets (clock, heap viewer)
  320.     HELPFILE.PAS - Help system manager
  321.     MOUSEDLG.PAS - Mouse options dialog
  322.     PUZZLE.PAS   - Simple brain teaser puzzle
  323.     DEMOCMDS.PAS - Command constants for TVDEMO.PAS
  324.     TVHC.PAS     - Help text compiler
  325.     DEMOHELP.TXT - Help file source for TVDEMO.PAS
  326.     TVRDEMO.PAS  - Resourced and overlaid version of TVDEMO.PAS
  327.     MKRDEMO.BAT  - Builds TVRDEMO.EXE
  328.     GENRDEMO.PAS - Used by TVRDMAKE.BAT to build resources for TVRDEMO.PAS
  329.     TVEDIT.PAS   - Application that demonstrates the EDITORS unit
  330.  
  331.     TVFORMS.PAS  - Form entry and edit application
  332.     FORMCMDS.PAS - Command constants
  333.     DATACOLL.PAS - Data record collection
  334.     LISTDLG.PAS  - List dialog manager
  335.     FIELDS.PAS   - Edit/entry fields
  336.     FORMS.PAS    - Form dialog manager
  337.     PARTS.TVF    - Sample data file
  338.     PHONENUM.TVF - Sample data file
  339.     GENFORMS.BAT - Generates sample data files for TVFORMS.PAS
  340.     GENFORM.PAS      - Used by GENFORMS.BAT
  341.     GENPARTS.PAS - Used by GENFORMS.BAT
  342.     GENPHONE.PAS - Used by GENFORMS.BAT
  343.  
  344.     FILEVIEW.PAS - Simple disk & file browser program
  345.     TVTXTDMO.PAS - Demonstrates TEXTVIEW unit
  346.  
  347.     TVBGI.PAS    - Demonstrates BGI support unit (GRAPHAPP)
  348.     GRAPHAPP.PAS - Support unit for swapping between Turbo Vision and BGI
  349.  
  350.   INTRFACE.ZIP   - Archived file containing the interface sections
  351.                    of Turbo Vision and runtime library units
  352.   TURBO3.ZIP     - Archived file containing TURBO3 and GRAPH3
  353.                    compatibility units and interface documentation
  354.   TOUR.ZIP       - Archived file containing the IDE Tour and its
  355.                    overlay files.
  356.   Online Help
  357.   -----------
  358.   HELP.ZIP       - Archived file containing:
  359.     TURBO.HLP    - Online help data file
  360.  
  361.   BGI/Utilities
  362.   -------------
  363.   BGI.ZIP        - Archived file containing BGI driver and support
  364.                    files:
  365.     GRAPH.TPU    - Borland Graphics Interface (BGI) Graph unit
  366.     ATT.BGI      - AT&T 6300 driver
  367.     CGA.BGI      - CGA and MCGA driver
  368.     EGAVGA.BGI   - EGA and VGA driver
  369.     HERC.BGI     - Hercules mono driver
  370.     PC3270.BGI   - 3270 PC driver
  371.     IBM8514.BGI  - IBM 8514 driver
  372.     GOTH.CHR     - Gothic font
  373.     LITT.CHR     - Small font
  374.     SANS.CHR     - Sans serif font
  375.     TRIP.CHR     - Triplex font
  376.     BGIDEMO.PAS  - Graph unit demo
  377.     ARTY.PAS     - Graph unit demo
  378.     BGILINK.PAS  - Graph unit demo
  379.     BGIDRIV.PAS  - BGILINK.PAS demo unit
  380.     BGIFONT.PAS  - BGILINK.PAS demo unit
  381.     BGILINK.MAK  - BGILINK.PAS demo makefile
  382.   UTILS.ZIP
  383.     THELP.COM    - TSR online help utility
  384.     TPUMOVER.EXE - Unit mover utility
  385.     TEMC.EXE     - Turbo Editor Macro Compiler
  386.     MAKE.EXE     - UNIX-style project management utility
  387.     GREP.COM     - Text file search utility
  388.     TOUCH.COM    - Changes a file's timestamp to force re-compilation
  389.     BINOBJ.EXE   - Converts a binary data file to an .OBJ file
  390.     EMSTEST.COM  - Expanded Memory (EMS) hardware/software diagnostic
  391.                    utility
  392.   DOCDEMOS.ZIP   - Archived file containing source code examples
  393.                    from the User's Guide and Turbo Vision Guide.
  394.   TCALC.ZIP      - Archived file contain the source code to the Turbo
  395.                    Calc demo program
  396.   DEMOS.ZIP      - Archived file contain numerous demo programs
  397.   ONLINE.ZIP     - Archived file contain online documentation files:
  398.     HELPME!.DOC  - Answers to commonly asked questions
  399.     FIXES.DOC    - Corrections to the printed documentation
  400.     TVISION.DOC  - Enhancements to Turbo Vision
  401.     BUFFERS.DOC  - Documents the Turbo Vision buffers unit
  402.     EDITORS.DOC  - Documents the Turbo Vision editors unit
  403.     TEMC.DOC     - Turbo Editor Macro Compiler documentation
  404.     THELP.DOC    - Turbo Help (TSR) documentation
  405.     UTILS.DOC    - TPUMOVER, MAKE, GREP, TOUCH, BINOBJ documentation
  406. ----------------------------------------------------------------------
  407.