home *** CD-ROM | disk | FTP | other *** search
- ========================================================================
- 1 Welcome to Clipper 5.01!
-
- Copyright (c) 1991 Nantucket Corporation. All rights reserved.
-
- Welcome to Clipper 5.01! This file contains the most up-to-date
- information about the product, including additional installation
- instructions and detailed distribution disk contents.
-
- During the installation procedure, two additional documentation
- files, Errata.doc and Debugger.doc, will be copied to the \CLIPPER5
- directory. Errata.doc is a text file that contains errata for the
- printed documentation. Debugger.doc is a print file that contains
- new documentation for The Clipper Debugger (CLD.EXE) which has been
- substantially revised. To print either of these files, use the
- following DOS command:
-
- C>COPY <filename> PRN:
-
- ========================================================================
- 2 What's New
-
- In Clipper 5.01, we have made many changes and improvements which
- include, but are not limited to:
-
- 1. Fixes to known anomalies
- 2. Increased Clipper Summer '87 compatibility
- 3. Improved performance
- 4. Improved runtime error handling and facilities
- 5. New and improved debugger
- 6. New and improved installation system
- 7. Added support for color in @...SAY...GET and box drawing
- commands
- 8. Revised Get system with new and documented API
- 9. New database functions that can be used in place of database
- commands
- 10. New screen functions that allow the display output system to
- buffer display updates
- 11. New memo functions to determine position based on formatting
- 12. Append mode for SET ALTERNATE and SET PRINTER files
- 13. Revised on-line documentation including:
-
- Release Notes documentation database
- Change Summaries for Clipper 5.0 and Clipper 5.01
- Errata for printed documentation
-
- For a complete list of new features, consult the Release Notes
- documentation database.
-
- ========================================================================
- 3 On-line Documentation
-
- There have been several changes made to Clipper 5.01 since the
- documentation was printed. The new information is covered either in
- the files mentioned above or in the on-line documentation. In the
- on-line documentation, new items that do not appear anywhere in the
- printed documentation are indicated with the Greek character Omega.
- Items that have been revised significantly since the documentation
- was printed are indicated with the Sigma character.
-
- The on-line documentation system consists of the Norton Instant
- Access Engine (NG.EXE) and several documentation databases that are
- listed below:
-
- C5G01A.NG The Guide To Clipper
- (Clipper language and reference tables)
-
- C5G02A.NG Error Messages
- (Compiler, linker, runtime, RMAKE error messages)
-
- C5G03A.NG Extend System
- (Extend function reference documentation)
-
- C5G04A.NG Utilities
- (Utilities reference documentation)
-
- C5G05A.NG Release Notes
- (Change summaries and topical information)
-
- C5G06A.NG Sample Reference
- (Reference for sample programs)
-
- All of the documentation databases and the Instant Access Engine are
- installed in the default configuration into \NG which exists at the
- same level as the \CLIPPER5 directory.
-
- Within the Instant Access Engine's Options:Database pick list, the
- names of the Clipper 5.01 documentation databases are formatted as
- follows:
-
- Clipper 5.01a >> The Guide To Clipper
- ^ ^ ^ ^
- | | | |_____ documentation database name
- | | |__________ database revision number
- | |______________ product version number
- |______________________ product name
-
- ========================================================================
- 4 Installation Problems
-
- This section provides information on the installation procedure for
- Clipper 5.01. If you have problems installing the software, consult
- the following list of problems and solutions. If you experience an
- installation problem not listed here, please contact Nantucket
- Support at the Nantucket office serving your country. Telephone
- numbers appear in the Contacting Nantucket section of the Product
- and Services Guide.
-
- When contacting Nantucket Support, have ready information about your
- environment such as: machine make and model, DOS version, memory
- available during installation, and any memory-resident software you
- are using.
-
-
- 4.1 Command-line Arguments
-
- The following table shows the command-line arguments for
- INSTALL.EXE.
-
- Table: INSTALL.EXE Command-line Arguments
- -------------------------------------------------------------------
- Argument Description
- -------------------------------------------------------------------
- /NOSWAP Do not swap to EMS or disk
- /BW Monochrome for color display (for Laptops)
- /MONO Force monochrome display
- -------------------------------------------------------------------
-
-
- 4.2 Problems and Solutions
-
- Some common problems that may occur during installation are listed
- below:
-
- 1. Problem: Missing files due to insufficient disk space on the
- target drive.
-
- Solution: Make more space available on the target drive and
- then run the install program again.
-
- 2. Problem: Insufficient memory to build utilities ("memory
- overbooked" messages).
-
- Solution: To build the utilities, INSTALL requires
- approximately 400KB of free memory when INSTALL.EXE is invoked.
- Make additional memory available by rebooting your computer
- without memory resident utilities or network software, then run
- INSTALL again. Alternatively, you can build the utility
- programs manually (see Building Utilities Manually below).
-
- 3. Problem: System hangs while building utilities.
-
- Solution: The install script file includes a SET PATH command
- to add some necessary directories to the PATH environment
- variable. Under some versions of DOS, attempting to increase
- the length of the PATH environment variable beyond 128 bytes
- causes COMMAND.COM to hang. Remove unnecessary entries from
- PATH and run INSTALL again. Alternatively, you can build the
- utility programs manually (see Building Utilities
- Manually below).
-
-
- 4.3 Modifying Your Environment Variables
-
- Certain environment (SET command) variables should be set for
- Clipper 5.01. If you elected to modify the AUTOEXEC.BAT file
- during the installation process, your file should be up-to-date.
- Otherwise, the appropriate settings should be in a file called
- AUTOEXEC.CHG located in the \CLIPPER5 directory. In either case,
- it is important that you modify your AUTOEXEC.BAT file to
- incorporate these additional settings so that Clipper 5.01 will
- know where to find files. The required settings are as follows:
-
- 1. The PATH variable should include the directory where Clipper
- 5.01 executable files reside (example: C:\CLIPPER5\BIN).
-
- 2. The LIB variable should include the directory where Clipper 5.01
- library files reside (example: C:\CLIPPER5\LIB).
-
- 3. The INCLUDE variable should include the directory where Clipper
- 5.01 include files reside (example: C:\CLIPPER5\INCLUDE).
-
- 3. The PLL variable should include the directory where Clipper 5.01
- pre-linked library files reside (example: C:\CLIPPER5\PLL).
-
- For example:
-
- SET PATH=C:\CLIPPER5\BIN;%PATH%
- SET LIB=C:\CLIPPER5\LIB
- SET INCLUDE=C:\CLIPPER5\INCLUDE
- SET PLL=C:\CLIPPER5\INCLUDE
-
- You may also wish to set other environment variables. For more
- information, refer to the Getting Started Guide and Programming and
- Utilities Guide. For general information about the DOS environment
- and setting environment variables, refer to your DOS manual.
-
-
- 4.4 Building Utilities Manually
-
- Certain Clipper 5.01 utility programs (DBU, PE, RL) are supplied in
- source code form. These utilities must be compiled and linked
- before they can be used. INSTALL will optionally install and
- build these utilities automatically. If you elected not to install
- or build the utilities or if INSTALL failed to build them
- successfully, they may be built manually.
-
- Before the utilities can be successfully built, the following
- requirements must be met:
-
- 1. The Clipper 5.01 executables, libraries, and include files (the
- files in C:\CLIPPER5\BIN, C:\CLIPPER5\LIB, and
- C:\CLIPPER5\INCLUDE, respectively) must be properly installed.
-
- 2. Your environment variables must be set correctly (see above).
-
- 3. The source files for the desired utility must be available. If
- the source files have not been transferred from the distribution
- disks, you can retrieve them using the INSTALL program.
-
- Each utility includes a make file (a .RMK file used by RMAKE) that
- will compile and link the utility. To make a utility, simply go to
- the appropriate directory and execute RMAKE on the script (.RMK)
- file. For example, to make the Database Utility, enter the
- following commands:
-
- C:
- CD \CLIPPER5\SOURCE\DBU
- RMAKE DBU
- COPY DBU.EXE \CLIPPER5\BIN
- COPY DBU.HLP \CLIPPER5\BIN
-
- Note that the make files for building the Clipper 5.01 utilities
- create the .EXE file in the current directory. If you copy the
- executable file into the \CLIPPER5\BIN directory, it will be
- accessible via SET PATH.
-
-
- 4.5 Building BASE50.PLL Manually
-
- Pre-linked libraries (.PLL files) allow faster linking and code
- sharing among different applications. The distribution disks
- contain a linker script file (BASE50.LNK) which will create a
- general purpose .PLL called BASE50.PLL (for information on building
- and using .PLL files, refer to the Programming and Utilities
- Guide).
-
- BASE50.PLL is optionally created during installation. If you
- elected not to create BASE50.PLL or if the install program did not
- create it successfully, you can create it manually. Before
- BASE50.PLL can be successfully created, the following requirements
- must be met:
-
- 1. The Clipper 5.01 executables, libraries, and include files (the
- files in C:\CLIPPER5\BIN, C:\CLIPPER5\LIB, and
- C:\CLIPPER5\INCLUDE, respectively) must be properly installed.
-
- 2. Your environment variables must be set correctly (see above).
-
- 3. The PLL directory (\CLIPPER5\PLL) must be created and the
- BASE50.LNK file must reside in it. If this file has not been
- transferred from the distribution disks, you can retrieve it
- using the INSTALL program.
-
- To build the BASE50.PLL, enter the following commands:
-
- C:
- CD \CLIPPER5\PLL
- RTLINK @BASE50
-
- ========================================================================
- 5 Distribution Disk Contents
-
- This section provides information regarding the contents of the
- Clipper 5.01 distribution disks. The files are described in general
- terms of their contents followed by several tables showing the
- various disk configurations.
-
-
- 5.1 Documentation Files
-
- The README file that you are viewing now is located on Disk 1.
-
-
- 5.2 Disk Identifier Files
-
- Each disk in the Clipper 5.01 package contains a file named DISK.ID
- that is used by the install program to verify version and disk
- number.
-
-
- 5.3 Install Files
-
- The install program (INSTALL.EXE) and the installation script
- (INSTALL.DAT) are located on Disk 1. Together, these two files
- allow you to install Clipper 5.01 onto your hard disk.
-
-
- 5.4 Archive Files
-
- The Clipper 5.01 distribution files are supplied in the form of
- archive files. Most of the archive files have a .LIF extension,
- but the file containing the main documentation database is split up
- into two files with .001 and .002 extensions. Each of the archive
- files is listed in the table below, followed by several tables
- showing the contents of each archive file.
-
-
- Table: Archive File Descriptions
- -------------------------------------------------------------------
- Archive Contents
- -------------------------------------------------------------------
- BIN1.LIF Linker and debugger files and other executables
- CLIPPER.LIF Compiler executable file
- DBU.LIF Database Utility source files
- DOC.LIF Additional documentation files
- INCLUDE.LIF Header files
- LIB1.LIF Support libraries
- LIB2.LIF Support libraries
- NG1.001 On-line documentation databases
- NG1.002 On-line documentation databases
- NG2.LIF Norton Instant Access Engine
- PE.LIF Program Editor source files
- PLL.LIF Linker script for base 5.01 pre-linked library
- RL.LIF Report and Label Utility source files
- SAMPLE.LIF Sample program source files
- SYS.LIF System component source files
- -------------------------------------------------------------------
-
-
- Table: BIN1.LIF Archive File Contents
- -------------------------------------------------------------------
- File Contents
- -------------------------------------------------------------------
- CL.BAT Compile and Link batch file
- CLD.EXE Clipper Debugger
- DBT50.EXE DBT update utility
- RTLINK.EXE .RTLink linker
- RTLINK.DAT .RTLink data file
- RTLINK.HLP .RTLink data file
- RTLINKST.COM .RTLink data file
- RMAKE.EXE RMAKE make utility
- RO.COM Read-only file status utility
- -------------------------------------------------------------------
-
-
- Table: CLIPPER.LIF Archive File Contents
- -------------------------------------------------------------------
- File Contents
- -------------------------------------------------------------------
- CLIPPER.EXE Clipper 5.01 compiler
- -------------------------------------------------------------------
-
-
- Table: DBU.LIF Archive File Contents
- -------------------------------------------------------------------
- File Contents
- -------------------------------------------------------------------
- DBU.LNK .RTLink script for DBU
- DBU.RMK RMAKE script for DBU
- DBU.HLP DBU help file
- DBU.PRG DBU source
- DBUCOPY.PRG DBU source
- DBUEDIT.PRG DBU source
- DBUHELP.PRG DBU source
- DBUINDX.PRG DBU source
- DBUSTRU.PRG DBU source
- DBUUTIL.PRG DBU source
- DBUVIEW.PRG DBU source
- -------------------------------------------------------------------
-
-
- Table: DOC.LIF Archive File Contents
- -------------------------------------------------------------------
- File Contents
- -------------------------------------------------------------------
- ERRATA.DOC Clipper 5.01 Errata Documentation
- DEBUGGER.DOC Revised Clipper Debugger Documentation
- -------------------------------------------------------------------
-
-
- Table: INCLUDE.LIF Archive File Contents
- -------------------------------------------------------------------
- File Contents
- -------------------------------------------------------------------
- ACHOICE.CH Header file for ACHOICE() function
- BOX.CH Header file for box string definitions
- DBEDIT.CH Header file for DBEDIT() function
- DBSTRUCT.CH Header file for DBSTRUCT() function
- DIRECTRY.CH Header file for DIRECTORY() function
- ERROR.CH Header file for runtime error system
- FILEIO.CH Header file for binary file I/O functions
- GETEXIT.CH Header file for Get system
- INKEY.CH Header file for keyboard functions
- MEMOEDIT.CH Header file for MEMOEDIT() function
- RESERVED.CH Header file for reserved words
- SET.CH Header file for SET() function
- SETCURS.CH Header file for SETCURS() function
- SIMPLEIO.CH Header file for standard I/O functions
- STD.CH Header file containing standard command set
- EXTEND.H Header file for C Extend functions
- EXTASM.INC Header file for Assembler Extend functions (5.01)
- EXTENDA.INC Header file for Assembler Extend functions (S87)
- EXTENDA.MAC Header file for Assembler Extend functions (A86)
- -------------------------------------------------------------------
-
-
- Table: LIB1.LIF Archive File Contents
- -------------------------------------------------------------------
- File Contents
- -------------------------------------------------------------------
- CLIPPER.LIB Clipper 5.01 support library
- -------------------------------------------------------------------
-
-
- Table: LIB2.LIF Archive File Contents
- -------------------------------------------------------------------
- File Contents
- -------------------------------------------------------------------
- CLD.LIB Clipper Debugger library
- DBFNTX.LIB Database driver
- EXTEND.LIB Clipper 5.01 support library
- RTLUTILS.LIB .RTLink static overlay support library
- TERMINAL.LIB Terminal I/O drivers
- -------------------------------------------------------------------
-
-
- Table: NG1.001 Archive File Contents
- -------------------------------------------------------------------
- File Contents
- -------------------------------------------------------------------
- C5G01A.NG Clipper 5.01 documentation database (partial)
- -------------------------------------------------------------------
-
-
- Table: NG1.002 Archive File Contents
- -------------------------------------------------------------------
- File Contents
- -------------------------------------------------------------------
- C5G01A.NG Clipper 5.01 documentation database (continued)
- -------------------------------------------------------------------
-
-
- Table: NG2.LIF Archive File Contents
- -------------------------------------------------------------------
- File Contents
- -------------------------------------------------------------------
- NG.EXE Norton Instant Access Engine
- C5G02A.NG Clipper 5.01 documentation database
- C5G03A.NG Clipper 5.01 documentation database
- C5G04A.NG Clipper 5.01 documentation database
- C5G05A.NG Clipper 5.01 documentation database
- C5G06A.NG Clipper 5.01 documentation database
- -------------------------------------------------------------------
-
-
- Table: PE.LIF Archive File Contents
- -------------------------------------------------------------------
- File Contents
- -------------------------------------------------------------------
- PE.PRG PE source
- PE.RMK RMAKE script for PE
- -------------------------------------------------------------------
-
-
- Table: PLL.LIF Archive File Contents
- -------------------------------------------------------------------
- File Contents
- -------------------------------------------------------------------
- BASE50.LNK .RTLink script for base 5.01 pre-linked library
- -------------------------------------------------------------------
-
-
- Table: RL.LIF Archive File Contents
- -------------------------------------------------------------------
- File Contents
- -------------------------------------------------------------------
- RL.RMK RMAKE script file for RL
- RLBACK.PRG RL source
- RLDIALG.PRG RL source
- RLFRONT.PRG RL source
- -------------------------------------------------------------------
-
-
- Table: SAMPLE.LIF Archive File Contents
- -------------------------------------------------------------------
- File Contents
- -------------------------------------------------------------------
- ARRAY.CH Header file for array manipulation examples
- ARRAY.PRG Array manipulation examples
- ASRTDEMO.PRG Error checking assertions example
- ASSERT.CH Header file for error checking assertions
- BOX.PRG Simple box menus
- BROWSE.PRG Database browser
- DATE.PRG Date manipulation functions
- DICT.CH Header file for keyed dictionary utility
- DICT.PRG Keyed dictionary utility
- DOT.PRG Dot prompt emulator
- ENVIRON.PRG File look up and state control functions
- EXAMPLEP.PRG Miscellaneous examples
- FILEIO.PRG Binary file manipulation
- FILEDEMO.PRG Demonstration of file manager function
- FILEDEMO.RMK RMAKE script for file manager function
- FILEMAN.CH Header file for file manager function
- FILEMAN.PRG File manager function
- GAUGDEMO.PRG Demonstration program for GAUGE.PRG
- GAUGE.PRG Status gauge functions
- ITERATOR.PRG Array iterator functions
- KEYBOARD.PRG Keyboard functions
- LOCKS.PRG Database file locking functions
- LOCKS87.CH Header file for S87 locking functions compatibility
- NUM.PRG Numeric functions
- ODEMO1.PRG Demonstration of menu functions
- ODEMO1.RMK RMAKE script for ODEMO1.PRG
- ODEMO2.PRG Demonstration of menu functions
- ODEMO2.RMK RMAKE script for ODEMO2.PRG
- OMENU.CH Header file for menu functions
- OMENU.DOC Documentation for menu functions
- OMENU.PRG Menu functions
- OMENU.RMK RMAKE script for menu functions
- PRINT.PRG Printer control function
- SCROLBAR.PRG Scroll bar functions
- STACK.PRG Functions to implement a stack data structure
- STATUS.PRG Status indicator function
- STRING.PRG String manipulation functions
- TBDEMO.PRG Example of using TBrowse objects
- TIME.PRG Time manipulation functions
- TIME87.CH Header file for S87 time functions compatibility
- VALEDIT.PRG Example of using Get objects
- EXAMPLEC.C Clipper/C interface examples
- EXAMPLEA.ASM Clipper/Assembler interface examples
- TEMPLATE.ASM Assembler source code example
- -------------------------------------------------------------------
-
-
- Table: SYS.LIF Archive File Contents
- -------------------------------------------------------------------
- File Contents
- -------------------------------------------------------------------
- ERRORSYS.PRG Source file for default runtime error handler
- FRMDEF.CH Header file for REPORT runtime system
- FRMBACK.PRG Source file for REPORT runtime system
- FRMRUN.PRG Source file for REPORT runtime system
- GETSYS.PRG Source file for default Get system
- LBLDEF.CH Header file for LABEL runtime system
- LBLBACK.PRG Source file for LABEL runtime system
- LBLRUN.PRG Source file for LABEL runtime system
- -------------------------------------------------------------------
-
-
- 5.5 Distribution Disk Contents
-
- Table: 360KB Disk Format
- -------------------------------------------------------------------
- Disk Contents
- -------------------------------------------------------------------
- Disk 1 DISK.ID, README, INSTALL.EXE, INSTALL.DAT,
- CLIPPER.LIF
- Disk 2 DISK.ID, BIN1.LIF
- Disk 3 DISK.ID, LIB1.LIF
- Disk 4 DISK.ID, INCLUDE.LIF, LIB2.LIF, PLL.LIF, SYS.LIF
- Disk 5 DISK.ID, DBU.LIF, PE.LIF, RL.LIF, SAMPLE.LIF
- Disk 6 DISK.ID, NG1.001
- Disk 7 DISK.ID, NG1.002, NG2.LIF
- -------------------------------------------------------------------
-
-
- Table: 720KB Disk Format
- -------------------------------------------------------------------
- Disk Contents
- -------------------------------------------------------------------
- Disk 1 DISK.ID, README, INSTALL.EXE, INSTALL.DAT, BIN1.LIF,
- CLIPPER.LIF, INCLUDE.LIF
- Disk 2 DISK.ID, LIB1.LIF, LIB2.LIF, NG2.LIF, PLL.LIF,
- SYS.LIF
- Disk 3 DISK.ID, NG1.001, NG1.002, DBU.LIF, PE.LIF, RL.LIF,
- SAMPLE.LIF
- -------------------------------------------------------------------
-
- ========================================================================
- 6 Copyrights
-
- The installation program used to install Clipper 5.01, INSTALL, is
- based on licensed software provided by Knowledge Dynamics Corp,
- Highway Contract 4 Box 185-H, Canyon Lake, Texas 78133-3508 (USA),
- 1-512-964-3994. INSTALL is Copyright (c) 1987-1991 by Knowledge
- Dynamics Corp which reserves all copyright protection worldwide.
- INSTALL is provided to you for the exclusive purpose use of
- installing Clipper 5.01. Nantucket has made modifications to the
- software as provided by Knowledge Dynamics Corp, and thus the
- performance and behavior of the INSTALL program shipped with Clipper
- 5.01 may not represent the performance and behavior of INSTALL as
- shipped by Knowledge Dynamics Corp. Nantucket is exclusively
- responsible for the support of Clipper 5.01, including support
- during the installation phase. In no event will Knowledge Dynamics
- Corp be able to provide any technical support for Clipper 5.01.
-
-
-
-
- * * *
-