home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 9 / 09.iso / l / l044 / 1.ddi / README < prev    next >
Encoding:
Text File  |  1990-10-23  |  17.3 KB  |  437 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.  TPCX
  25. 11.  Complete List of Files
  26.  
  27.  
  28.  1. HOW TO GET HELP
  29. -------------------
  30. If you have any problems, please read this file, the *.DOC files in
  31. \TP\DOC, and the Turbo Pascal manuals first. If you still have a
  32. question and need assistance, help is available from the following
  33. sources:
  34.  
  35. 1. Type GO BPROGA on the CompuServe bulletin board system. If you are
  36.    not a member of CompuServe, see the enclosed special offer.
  37.  
  38. 2. Check with your software dealer or user group.
  39.  
  40. 3. Write to us:
  41.  
  42.    Borland International
  43.    Turbo Pascal 6.0 Technical Support
  44.    1800 Green Hills Road
  45.    P.O. Box 660001
  46.    Scotts Valley, CA  95067-0001
  47.  
  48.    Please include your serial number or we will be unable to process
  49.    your letter.
  50.  
  51. 4. If you have an urgent problem and you have sent in the license
  52.    agreement that accompanied this package, you may call the Borland
  53.    Technical Support Department at (408) 438-5300. Please have the
  54.    following information ready before calling:
  55.  
  56.    a. Product name and serial number from the distribution disks.
  57.  
  58.    b. Product version number. Both the IDE and the command-line
  59.       compiler display a version number when they are executed.
  60.  
  61.    c. Computer brand, model, and the brands and model numbers of
  62.       any additional hardware.
  63.  
  64.    d. Operating system and version number. (The version number can
  65.       be determined by typing VER at the DOS prompt.)
  66.  
  67.    e. Contents of your AUTOEXEC.BAT and CONFIG.SYS files.
  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 Turbo-driven compiler let's you build very large applications by
  150.   using extended memory on 80286-compatible systems.
  151.  
  152. o Private fields and methods are now supported in an object
  153.   declaration. This enables you to "enforce" encapsulation. Object
  154.   privacy is implemented consistently with the existing data hiding
  155.   capabilities of a unit. See P-87 in the User's Guide and P-35 in the
  156.   Programmer's Guide for more information.
  157.  
  158. o Other enhancements include:
  159.   o New Objects unit with better collections and streams.
  160.   o New heap manager is faster and safer.
  161.   o Extended syntax compiler directive {$X} allows you to
  162.     optionally discard function results.
  163.   o New procedure directives: far, near and assembler.
  164.   o 80286 code generation directive {$G}.
  165.   o Minor code generation improvements.
  166.   o Address references in typed constant pointers.
  167.   o Link in initialized data from .OBJs {$L}.
  168.  
  169.  
  170. 6. TURBO VISION EXAMPLES
  171. ------------------------
  172. There are three different kinds of Turbo Vision example programs
  173. provided. You'll find all the example programs from the Turbo Vision
  174. Guide in the \TP\DOCDEMOS directory. You'll find several Turbo Vision
  175. application support units in the \TP\TVISION directory. And you'll
  176. find several Turbo Vision demonstration programs in the \TP\TVDEMOS
  177. directory.
  178.  
  179. If you're trying to run one of the Turbo Vision demos from inside the
  180. IDE, we recommend that you set Compile|Destination to disk and the
  181. Link Buffer option to Disk (in the Options|Linker dialog box). Many of
  182. these examples are large programs and require full memory capacity to
  183. compile and run. Depending on your system configuration, you may need
  184. to compile and run them from DOS. Here's how to use the command-line
  185. compiler on TVDEMO.PAS:
  186.  
  187.   cd \tp\tvdemos
  188.   tpc /m tvdemo
  189.  
  190. Then run TVDEMO.PAS from DOS by typing:
  191.  
  192.   tvdemo
  193.  
  194. In order to facilitate compiling these demos on a wide variety of
  195. system configurations, we've turned off debug information {$D-} in all
  196. Turbo Vision units. If you have a system with lots of memory and EMS,
  197. you might want to enable the {$D} compiler directive in selected units
  198. in \TP\TVDEMOS so you can step through the code.
  199.  
  200.  
  201. 7. IMPORTANT DOCUMENTATION INFORMATION
  202. --------------------------------------
  203. All source code examples from the Turbo Vision Guide and from the
  204. User's Guide's chapter on object-oriented programming (chapter 4) can
  205. be found in the \TP\DOCDEMOS directory.
  206.  
  207.  
  208. 8.  Compatibility notes
  209. -----------------------
  210.  
  211. Turbo Pascal 6.0 Heap Manager
  212. -----------------------------
  213. The new heap manager is faster and more efficient than in Turbo Pascal
  214. 5.x. FreeMin is no longer needed and you can simply delete all
  215. references to it in your programs. FreePtr has been replaced. If
  216. you're relying on implementation-dependent features of the old heap
  217. manager, you'll have to modify your code to eliminate references to
  218. FreePtr. (If you just need to compress the heap, you can call the
  219. SetMemTop procedure from the Turbo Vision Memory unit.) See Chapter 16
  220. in the Programmer's Guide for more information about how the new heap
  221. manager works.
  222.  
  223. If you are using a HeapError function, make sure it exits quickly when
  224. passed a Size value of 0:
  225.  
  226.   function HeapError(Size: Word): Integer; far;
  227.   begin
  228.     if Size > 0 then
  229.     begin
  230.       { ... perform HeapError processing here ... }
  231.     end;
  232.   end;
  233.  
  234. In version 6.0, HeapError is called with a value of 0 whenever an
  235. allocation moves the HeapPtr upwards.
  236.  
  237.  
  238. Turbo Pascal 6.0 and the Toolboxes
  239. ----------------------------------
  240. The 4.0 toolboxes all work with Turbo Pascal 6.0. (The Turbo Editor
  241. Toolbox needs 2 easy source code modifications to work with 6.0. See
  242. the file HELPME!.DOC in \TP\DOC for more information.)
  243.  
  244.  
  245. Turbo Pascal 5.5 Object Unit
  246. ----------------------------
  247. All the demo units and programs from Turbo Pascal 5.5 will work with
  248. version 6.0 if you recompile them. However, we recommend that you use
  249. the new Object unit's streams and collections in any new programs you
  250. write. Note that you cannot use the 5.5 Objects unit with Turbo
  251. Vision.
  252.  
  253.  
  254. 9. Testing Expanded Memory: EMSTEST.COM
  255. ---------------------------------------
  256. EMSTEST.COM is in the \TP\UTILS directory and can be used to test your
  257. Expanded Memory (EMS) hardware and software. If you have problems
  258. using Turbo Pascal with your EMS, type EMSTEST at the DOS prompt and
  259. follow the instructions. (To disable the IDE's EMS usage, specify /X-
  260. on the commandline when you load TURBO. To determine how much EMS the
  261. IDE is using, load TURBO and select GET INFO on the FILE menu.)
  262.  
  263.  
  264. 10. TPCX
  265. --------
  266. TPCX, the extended memory command-line compiler, provides more
  267. compilation capacity by running in protected mode. It only may be used
  268. on 80286-compatible machines (80386, 80486, etc.) that have at least 1
  269. mbyte of extended memory.
  270.  
  271.  
  272. TPCX and Ctrl-Break
  273. -------------------
  274. WARNING: When you run TPCX, it loads a DOS-extender kernel into memory
  275. and then begins compiling. If you load TPCX and then want to terminate
  276. the compilation early, do not press Ctrl-C or Ctrl-Break while the
  277. kernel is being loaded! Instead, wait until you see the compilation
  278. begin before interrupting. (Once you see the signon and copyright text
  279. on the screen, it is safe to press Ctrl-C or Ctrl-Break.)
  280.  
  281. TPCX, disk caches and RAM disks
  282. -------------------------------
  283. Some older disk caches and RAM disks do not follow current industry
  284. conventions for allocating extended memory and thus TPCX has no way to
  285. detect their presence. If you've loaded a disk cache or RAM disk that
  286. uses extended memory, you must make sure it's "well-behaved" before
  287. running TPCX. You might do so by running TDMEM with and without these
  288. disk utilities and comparing the amount of extended memory available.
  289. When in doubt, remove your disk cache from extended memory before
  290. running TPCX.EXE or TD286.EXE.
  291.  
  292.  
  293. 11. Complete List of Files
  294. --------------------------
  295. The INSTALL program will place all of the following on your hard disk
  296. during the installation process (the floppy installation installs only
  297. TURBO.TPL and TURBO.EXE or TPC.EXE):
  298.  
  299.   Install/Compiler
  300.   ----------------
  301.   INSTALL.EXE    - Installs Turbo Pascal on your system
  302.   README.COM     - Program to display README file
  303.   UNZIP.EXE      - De-archiving program
  304.   TURBO.ZIP      - Archived file containing:
  305.     TURBO.EXE    - Turbo Pascal Integrated Development Environment
  306.     TURBO.TPL    - Resident units for Turbo Pascal
  307.     TURBO.TP     - Configuration file for TURBO.EXE
  308.     TPC.EXE      - Command-line version of Turbo Pascal
  309.   README         - This file!
  310.  
  311.   Turbo Vision/Tour
  312.   -----------------
  313.   TVISION.ZIP    - Archived file containing Turbo Vision units:
  314.     APP.PAS      - Application unit source
  315.     BUFFERS.PAS  - Buffers unit source
  316.     COLORSEL.PAS - Color installation unit source
  317.     EDITORS.PAS  - Editors unit source
  318.     MSGBOX.PAS   - Message box unit source
  319.     STDDLG.PAS   - Standard dialogs unit source
  320.     APP.TPU      - Application unit
  321.     BUFFERS.TPU  - Buffers unit
  322.     COLORSEL.TPU - Color installation unit
  323.     DIALOGS.TPU  - Dialogs unit
  324.     DRIVERS.TPU  - Drivers unit
  325.     EDITORS.TPU  - Editors unit
  326.     HISTLIST.TPU - History list unit
  327.     MEMORY.TPU   - Memory management unit
  328.     MENUS.TPU    - Menus unit
  329.     MSGBOX.TPU   - Messagebox unit
  330.     OBJECTS.TPU  - Objects unit
  331.     STDDLG.TPU   - Standard dialogs unit
  332.     TEXTVIEW.TPU - Simple text window unit
  333.     VIEWS.TPU    - Views unit
  334.  
  335.   TVDEMOS.ZIP    - Archived file containing Turbo Vision demos:
  336.     TVDEMO.PAS   - Turbo Vision demo application
  337.     DEMOHELP.HLP - Compiled help file for TVDEMO
  338.     ASCIITAB.PAS - ASCII table viewer
  339.     CALC.PAS     - Desktop calculator
  340.     CALENDAR.PAS - Desktop calendar (monthly viewer)
  341.     DEMOHELP.PAS - Context file produced by running HC on DEMOHELP.TXT
  342.     FVIEWER.PAS  - Text file viewer
  343.     GADGETS.PAS  - Desktop gadgets (clock, heap viewer)
  344.     HELPFILE.PAS - Help system manager
  345.     MOUSEDLG.PAS - Mouse options dialog
  346.     PUZZLE.PAS   - Simple brain teaser puzzle
  347.     DEMOCMDS.PAS - Command constants for TVDEMO.PAS
  348.     TVHC.PAS     - Help text compiler
  349.     DEMOHELP.TXT - Help file source for TVDEMO.PAS
  350.     TVRDEMO.PAS  - Resourced and overlaid version of TVDEMO.PAS
  351.     MKRDEMO.BAT  - Builds TVRDEMO.EXE
  352.     GENRDEMO.PAS - Used by TVRDMAKE.BAT to build resources for TVRDEMO.PAS
  353.     TVEDIT.PAS   - Application that demonstrates the EDITORS unit
  354.  
  355.     TVFORMS.PAS  - Form entry and edit application
  356.     FORMCMDS.PAS - Command constants
  357.     DATACOLL.PAS - Data record collection
  358.     LISTDLG.PAS  - List dialog manager
  359.     FIELDS.PAS   - Edit/entry fields
  360.     FORMS.PAS    - Form dialog manager
  361.     PARTS.TVF    - Sample data file
  362.     PHONENUM.TVF - Sample data file
  363.     GENFORMS.BAT - Generates sample data files for TVFORMS.PAS
  364.     GENFORM.PAS  - Used by GENFORMS.BAT
  365.     GENPARTS.PAS - Used by GENFORMS.BAT
  366.     GENPHONE.PAS - Used by GENFORMS.BAT
  367.  
  368.     FILEVIEW.PAS - Simple disk & file browser program
  369.     TVTXTDMO.PAS - Demonstrates TEXTVIEW unit
  370.  
  371.     TVBGI.PAS    - Demonstrates BGI support unit (GRAPHAPP)
  372.     GRAPHAPP.PAS - Support unit for swapping between Turbo Vision and BGI
  373.  
  374.   INTRFACE.ZIP   - Archived file containing the interface sections
  375.                    of Turbo Vision and runtime library units
  376.   TURBO3.ZIP     - Archived file containing TURBO3 and GRAPH3
  377.                    compatibility units and interface documentation
  378.   TOUR.ZIP       - Archived file containing the IDE Tour and its
  379.                    overlay files.
  380.   Online Help
  381.   -----------
  382.   HELP.ZIP       - Archived file containing:
  383.     TURBO.HLP    - Online help data file
  384.  
  385.   BGI/Utilities
  386.   -------------
  387.   BGI.ZIP        - Archived file containing BGI driver and support
  388.                    files:
  389.     GRAPH.TPU    - Borland Graphics Interface (BGI) Graph unit
  390.     ATT.BGI      - AT&T 6300 driver
  391.     CGA.BGI      - CGA and MCGA driver
  392.     EGAVGA.BGI   - EGA and VGA driver
  393.     HERC.BGI     - Hercules mono driver
  394.     PC3270.BGI   - 3270 PC driver
  395.     IBM8514.BGI  - IBM 8514 driver
  396.     GOTH.CHR     - Gothic font
  397.     LITT.CHR     - Small font
  398.     SANS.CHR     - Sans serif font
  399.     TRIP.CHR     - Triplex font
  400.     BGIDEMO.PAS  - Graph unit demo
  401.     ARTY.PAS     - Graph unit demo
  402.     BGILINK.PAS  - Graph unit demo
  403.     BGIDRIV.PAS  - BGILINK.PAS demo unit
  404.     BGIFONT.PAS  - BGILINK.PAS demo unit
  405.     BGILINK.MAK  - BGILINK.PAS demo makefile
  406.   UTILS.ZIP
  407.     THELP.COM    - TSR online help utility
  408.     TPUMOVER.EXE - Unit mover utility
  409.     TEMC.EXE     - Turbo Editor Macro Compiler
  410.     MAKE.EXE     - UNIX-style project management utility
  411.     GREP.COM     - Text file search utility
  412.     TOUCH.COM    - Changes a file's timestamp to force re-compilation
  413.     BINOBJ.EXE   - Converts a binary data file to an .OBJ file
  414.     EMSTEST.COM  - Expanded Memory (EMS) hardware/software diagnostic
  415.                    utility
  416.   DOCDEMOS.ZIP   - Archived file containing source code examples
  417.                    from the User's Guide and Turbo Vision Guide.
  418.   TCALC.ZIP      - Archived file contain the source code to the Turbo
  419.                    Calc demo program
  420.   DEMOS.ZIP      - Archived file contain numerous demo programs
  421.   ONLINE.ZIP     - Archived file contain online documentation files:
  422.     HELPME!.DOC  - Answers to commonly asked questions
  423.     FIXES.DOC    - Corrections to the printed documentation
  424.     TVISION.DOC  - Enhancements to Turbo Vision
  425.     BUFFERS.DOC  - Documents the Turbo Vision buffers unit
  426.     EDITORS.DOC  - Documents the Turbo Vision editors unit
  427.     TEMC.DOC     - Turbo Editor Macro Compiler documentation
  428.     THELP.DOC    - Turbo Help (TSR) documentation
  429.     UTILS.DOC    - TPUMOVER, MAKE, GREP, TOUCH, BINOBJ documentation
  430.  
  431.   TPCX
  432.   ----
  433.   TPCX.EXE       - Extended memory, command-line version of Turbo Pascal
  434.   TPCXINST.EXE   - Installation program for TPCX.EXE
  435.   CPUTEST.EXE    - CPU diagnostic utility for TPCX.EXE
  436. ----------------------------------------------------------------------
  437.