dos_compilers/Digital Research CB-86 v2/READ.ME2

852 lines
26 KiB
Plaintext
Raw Permalink Normal View History

2024-06-30 20:56:20 +02:00
------------------------------------------------------------------
| |
| |
| |
| |
| ================================================ |
| | | |
| | | |
| | ***** CBASIC Compiler CB86 ***** | |
| | | |
| | with GSX-86 Graphics Extensions | |
| | | |
| | for the IBM Personal Computer | |
| | Disk Operating System | |
| | | |
| | --------------- | |
| | | |
| | READ.ME File Notes | |
| | | |
| | (File #2 of 2) | |
| | | |
| | - January 1984 - | |
| | | |
| | Digital Research Inc. | |
| | P.O. Box 579 | |
| | Pacific Grove, CA 93950 | |
| | | |
| ================================================ |
| |
| |
| |
| This file describes enhancements and modifications |
| made to the Digital Research CBASIC Compiler - CB86 |
| with GSX-86 Graphics Extensions. Changes described |
| in this file apply to GSX-86 software Version 1.0, |
| the "GSX-86 User's Guide for the IBM Personal |
| Computer Disk Operating System" First Edition: |
| August 1983, and the "CBASIC Compiler Language |
| Graphics Guide" First Edition May 1983. |
| |
| You can print the information in this file on your |
| line printer using 8 by 11 inch paper with the |
| printer set to 6 lines per inch. You can trim the |
| pages along the dotted lines and place the pages |
| in your product documentation binder. NOTE: This |
| file contains TABS which must be expanded. |
| |
| |
| |
| |
------------------------------------------------------------------
__________________________________________________________________
| CBASIC Compiler - CB86 READ.ME File Notes January 1984 |
| |
| |
| |
| |
| TABLE of CONTENTS |
| ====================================================== |
| |
| GSX-86 SOFTWARE NOTES . . . . . . . . . . . . Page 1 |
| CBASIC GRAPHICS GUIDE NOTES . . . . . . . . . Page 3 |
| CBASIC GRAPHICS EXTENSION ERROR MESSAGES . . . Page 5 |
| GSX-86 USER'S GUIDE NOTES . . . . . . . . . . Page 8 |
| THE GSX-86 PROGRAMMER'S TOOL KIT . . . . . . . Page 9 |
| Language Binding Software and Documentation . Page 10 |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| Page i. |
| |
------------------------------------------------------------------
------------------------------------------------------------------
| CBASIC Compiler - CB86 READ.ME File Notes January 1984 |
| |
| |
| GSX-86 SOFTWARE NOTES |
| =========================================== |
| |
| o To use GSX-86, you must have Version 1.1 or later |
| versions of IBM Personal Computer DOS. |
| |
| o The file GRAPHICS.EXE, described in your GSX-86 User's |
| Guide on page 3-1, has been replaced on your product |
| disk with the file GSX.EXE. Use GSX.EXE with the |
| following command to install GSX-86: A>GSX |
| |
| o The following table defines the six monitor driver |
| files for the IBM Personal Computer. Each driver is |
| described in detail following this table. This |
| information replaces monitor driver descriptions in |
| Section 4 of the GSX-86 User's Guide. |
| |
| Monitor Filename Support |
| ------------------------------------------------------ |
| Monochrome IBMMM1P1.SYS IBM Color/Graphics Monitor |
| Adaptor Card in monochrome |
| mode and PC Mouse by Mouse |
| Systems. |
| |
| IBMMMSP1.SYS IBM Color/Graphics Monitor |
| Adaptor Card in monochrome |
| mode and Microsoft Mouse. |
| |
| IBMHM1P1.SYS Hercules Graphics Card |
| with PC Mouse by Mouse |
| Systems. |
| |
| IBMHMSP1.SYS Hercules Graphics Card and |
| Microsoft Mouse. |
| |
| Color IBMCM1P1.SYS IBM Color/Graphics Monitor |
| Adaptor Card in color mode |
| and PC mouse by Mouse |
| Systems. |
| |
| IBMCMSP1.SYS IBM Color/Graphics Monitor |
| Adaptor Card and Microsoft |
| Mouse. |
| |
| Page 1 |
| |
------------------------------------------------------------------
------------------------------------------------------------------
| CBASIC Compiler - CB86 READ.ME File Notes January 1984 |
| |
| |
| All drivers described here accept keyboard characters |
| and do not require a mouse for proper operation. You |
| can use the arrow keys to position the graphics cursor. |
| |
| |
| IBMMM1P1.SYS This driver supports the IBM Color |
| Adaptor Card in monochrome mode with or |
| without the PC Mouse by Mouse Systems. |
| |
| To use the PC Mouse, connect it to |
| comm 1 (one of two RS-232 ports on your |
| IBM Personal Computer). The driver |
| initializes comm 1 for the appropriate |
| baud rate, parity, stop bits, and other |
| communications protocol necessary to use |
| the PC Mouse. If you use comm 1 with a |
| printer, plotter, or modem after using |
| it with a PC Mouse, reset communications |
| protocol for that particular device. |
| |
| IBMMMSP1.SYS This driver supports the IBM Color |
| Adaptor Card in monochrome mode with or |
| without the Microsoft Mouse. |
| |
| IBMHM1P1.SYS This driver supports the Hercules |
| Graphics Card with or without the PC |
| Mouse by Mouse Systems. |
| |
| To use the PC Mouse, connect it to |
| comm 1 (one of two RS-232 ports on your |
| IBM Personal Computer). The driver |
| initializes comm 1 for the appropriate |
| baud rate, parity, stop bits, and other |
| communications protocol necessary to use |
| the PC Mouse. If you use comm 1 with a |
| printer, plotter, or modem after using |
| it with a PC Mouse, reset communications |
| protocol for that particular device. |
| |
| IBMHMSP1.SYS This driver supports the Hercules |
| Graphics Card with or without the |
| Microsoft Mouse. |
| |
| Page 2 |
| |
------------------------------------------------------------------
------------------------------------------------------------------
| CBASIC Compiler - CB86 READ.ME File Notes January 1984 |
| |
| |
| IBMCM1P1.SYS This driver supports the Hercules |
| Graphics Card with or without the PC |
| Mouse by Mouse Systems. |
| |
| To use the PC Mouse, connect it to |
| comm 1 (one of two RS-232 ports on your |
| IBM Personal Computer). The driver |
| initializes comm 1 for the appropriate |
| baud rate, parity, stop bits, and other |
| communications protocol necessary to use |
| the PC Mouse. If you use comm 1 with a |
| printer, plotter, or modem after using |
| it with a PC Mouse, reset communications |
| protocol for that particular device. |
| |
| IBMCMSP1.SYS This driver supports the IBM Color |
| Adaptor Card in color mode with or |
| without the Microsoft Mouse. |
| |
| o The DEMOGRAF program on your product disk has been |
| modified. Therefore, the listing of DEMOGRAF in |
| Appendix A of the CBASIC Compiler Graphics Guide is |
| inaccurate. DEMOGRAF.BAS contains the improved source |
| code. |
| |
| |
| CBASIC GRAPHICS GUIDE NOTES |
| ====================================================== |
| |
| The following issues apply to the "CBASIC Compiler |
| Language Graphics Guide" First Edition: May 1983. |
| |
| 1. Add the following statement to the graphics cursor |
| explanation on page 1-7. |
| |
| >> The term "cursor" refers to the current print |
| position for non-graphics output. The graphics |
| cursor only displays during execution of the |
| GRAPHIC INPUT statement. The cursor position at |
| the time the GRAPHIC INPUT statement executes, is |
| determined by the current position of the beam. |
| The position to which you move the graphics cursor |
| has no effect on the position of the beam. |
| |
| Page 3 |
| |
------------------------------------------------------------------
__________________________________________________________________
| CBASIC Compiler - CB86 READ.ME File Notes January 1984 |
| |
| |
| |
| 2. The file GRAPHICS.EXE, described in your GSX-86 |
| User's Guide on page 3-1, has been replaced on your |
| product disk with the file GSX.EXE. Replace all |
| references to GRAPHICS.CMD on pages 2-2 and 2-3 in |
| the Graphics Guide with GSX.EXE. |
| |
| 3. Page 3-4 -- The boundaries of the device are |
| initially set to (1,1) upon execution of the |
| GRAPHIC OPEN statement. |
| |
| 4. Replace the explanation of the CLEAR statement on |
| page 3-10 with the following explanation. |
| |
| > The CLEAR statement clears the screen, and returns |
| the graphics cursor and beam to position (0,0). < |
| |
| 5. Page 3-25 -- The default LINE STYLE value is 1. |
| |
| 6. Page 3-30 -- The default MARKER TYPE value is 1. |
| |
| 7. Page 3-40 -- The beam and graphics cursor position |
| are initially set to (0,0) when a GRAPHIC OPEN |
| statement is executed. |
| |
| 8. Page 3-44 -- The default TEXT ANGLE is 0 radians. |
| |
| 9. Page 3-47 -- The VIEWPORT bounds are initially set |
| to 0,1,0,1 upon execution of a GRAPHIC OPEN |
| statement. |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| Page 4 |
| |
------------------------------------------------------------------
__________________________________________________________________
| CBASIC Compiler - CB86 READ.ME File Notes January 1984 |
| |
| |
| CBASIC GRAPHICS EXTENSION ERROR MESSAGES |
| ====================================================== |
| |
| The following error messages indicate compilation |
| errors that can occur during compilation of a graphics |
| statement in a program. Compilation continues after |
| the error is recorded. Errors 180 to 240 are reserved |
| for use with the CBASIC Compiler graphics extension. |
| |
| |
| Error Meaning |
| |
| 180 A left parenthesis is missing. A left |
| parenthesis is inserted. |
| |
| 181 A right parenthesis is missing. A right |
| parenthesis is inserted. |
| |
| 182 A comma is missing in a PLOT statement. |
| A comma is inserted. |
| |
| 183 The keyword STYLE is missing in a SET or |
| ASK statement. STYLE is inserted. |
| |
| 184 A comma is missing in a SET statement. A |
| comma is inserted. |
| |
| 185 The keyword HEIGHT is missing in a SET or |
| ASK CHARACTER statement. HEIGHT is |
| inserted. |
| |
| 186 The keyword ANGLE is missing in a SET or |
| ASK TEXT statement. ANGLE is inserted. |
| |
| 187 A comma is missing in a SET or ASK WINDOW |
| statement. A comma is inserted. |
| |
| 188 A comma is missing in a SET or ASK |
| VIEWPORT statement. A comma is inserted. |
| |
| 189 The keyword PAGE is missing in a SET |
| statement. PAGE is inserted. |
| |
| |
| Page 5 |
| |
------------------------------------------------------------------
------------------------------------------------------------------
| CBASIC Compiler - CB86 READ.ME File Notes January 1984 |
| |
| |
| |
| 190 Not used. |
| |
| 191 The keyword COUNT is missing in a ASK |
| STYLE statement. COUNT is inserted. |
| |
| 192 A comma is missing in an ASK statement. |
| A comma is inserted. |
| |
| 193 Not used. |
| |
| 194 Not used. |
| |
| 195 The keyword COUNT is missing in a SET |
| COLOR statement. COLOR is inserted. |
| |
| 196 Not used. |
| |
| 197 Not used. |
| |
| 198 Not used. |
| |
| 199 Not used. |
| |
| 200 Not used. |
| |
| 201 Not used. |
| |
| 202 Not used. |
| |
| 203 A comma is missing in an GRAPHIC statement. |
| A comma is inserted. |
| |
| 204 The keyword following GRAPHIC is unexpected. |
| INPUT is inserted. |
| |
| 205 A left parenthesis is missing in a GRAPHIC |
| statement. A left parenthesis is inserted. |
| |
| 206 A right parenthesis is missing in a GRAPHIC |
| statement. A right parenthesis is inserted. |
| |
| |
| |
| Page 6 |
| |
------------------------------------------------------------------
------------------------------------------------------------------
| CBASIC Compiler - CB86 READ.ME File Notes January 1984 |
| |
| |
| |
| 207 A colon is missing in a GRAPHIC statement. |
| A colon is inserted. |
| |
| 208 The variable in an ASK statement is of type |
| real or string. An integer variable is |
| required. |
| |
| 209 The variable in an ASK statement is of type |
| integer or string. A real variable is |
| required. |
| |
| 210 The variable in an ASK statement is of type |
| integer or real. A string variable is |
| required. |
| |
| 211 Not used. |
| |
| 212 Not used. |
| |
| 213 Not used. |
| |
| 214 Not used. |
| |
| 215 Not used. |
| |
| 216 A comma is missing in a GRAPHIC statement. |
| A comma is inserted. |
| |
| 217 The variable in a MAT statement is of type |
| integer or string. A real variable is |
| required. |
| |
| 218 Not used. |
| |
| 219 Not used. |
| |
| 220 Not used. |
| |
| 221 The keyword following MAT is unexpected. |
| FILL is inserted. |
| |
| |
| |
| Page 7 |
| |
------------------------------------------------------------------
------------------------------------------------------------------
| CBASIC Compiler - CB86 READ.ME File Notes January 1984 |
| |
| |
| |
| 222 A colon is missing in a MAT statement. A colon |
| is inserted. |
| |
| 223 An identifier is missing in a MAT statement. |
| An identifier is inserted. |
| |
| 224 A comma is missing in a MAT statement. A |
| comma is inserted. |
| |
| |
| GSX-86 USER'S GUIDE NOTES |
| ====================================================== |
| |
| The following issues apply to the "GSX-86 User's Guide |
| for the IBM Personal Computer Disk Operating System." |
| First Edition: August 1983. |
| |
| 1. Page 4-19 indicates that the "monitors support 182 |
| marker sizes and 5 marker types." This GSX-86 |
| implementation supports only 1 marker size and 5 |
| marker types. |
| |
| 2. Page 4-20 indicates that the "IBM PC supports 182 |
| character sizes". This GSX-86 implementation |
| supports only one character size. |
| |
| 3. Page 4-22 indicates that you can "move the graphic |
| cursor in 45 degree angles by pressing the 7, 9, 1, |
| and 3 keys on the numeric keypad." In this |
| implementation of GSX-86, the 7 key homes the |
| graphic cursor to position (0,0). The other keys |
| terminate GRAPHIC INPUT. |
| |
| 4. Page 4-22 indicates that "pressing the insert (INS) |
| key changes the distance between large and small |
| movements." In this implementation of GSX-86, the |
| SHIFT and NUM LOCK keys toggle between large and |
| small increment graphics cursor movement. |
| |
| |
| |
| |
| |
| Page 8 |
| |
------------------------------------------------------------------
------------------------------------------------------------------
| CBASIC Compiler - CB86 READ.ME File Notes January 1984 |
| |
| |
| THE GSX-86 PROGRAMMER'S TOOL KIT |
| ====================================================== |
| |
| Graphics command keywords incorporated into the CB86 |
| programming language are somewhat limited for the |
| commercial software developer. Therefore, if you |
| require additional graphics flexability, consider the |
| GSX-86 Programmer's Tool Kit available from Digital |
| Research. |
| |
| The GSX-86 Tool Kit provides monitor drivers and |
| language binding software for the CP/M-86 operating |
| system as well as IBM Personal Computer DOS. Of |
| primary interest to the commercial programmer, the |
| Tool Kit includes a licensing agreement enabling legal |
| redistribution of the GSX-86 product configured for |
| your IBM Personal Computer applications programs. |
| |
| The following list defines the contents of the GSX-86 |
| Programmer's Tool Kit. |
| |
| GSX-86 Programmer's Tool Kit Software/Documentation |
| ------------------------------------------------------ |
| |
| o GSX-86 V1.0 for DOS (5 1/4" DS/DD) |
| |
| Monitor Drivers: |
| - IBM Color/Graphics Monitor Adaptor Card |
| (monochrome graphics mode) |
| - IBM Color/Graphics Monitor Adaptor Card |
| (monochrome graphics mode/mouse support) |
| - IBM Color/Graphics Monitor Adaptor Card |
| (color graphics mode) |
| - IBM Color/Graphics Monitor Adaptor Card |
| (color graphics mode/mouse support) |
| - Hercules Graphics Card |
| (monochrome graphics mode) |
| - Hercules Graphics Card |
| (monochrome graphics mode/mouse support) |
| |
| Peripheral Device Drivers: |
| - Includes all drivers that are provided in the latest |
| version of GSX-86 for IBM Personal Computer DOS. |
| |
| Page 9 |
| |
------------------------------------------------------------------
------------------------------------------------------------------
| CBASIC Compiler - CB86 READ.ME File Notes January 1984 |
| |
| |
| |
| o GSX-86 V1.0 for CP/M-86 (5 1/4" DS/DD) |
| |
| Monitor Drivers: |
| - IBM Color/Graphics Monitor Adaptor Card |
| (monochrome graphics mode) |
| - IBM Color/Graphics Monitor Adaptor Card |
| (monochrome graphics mode/mouse support) |
| - IBM Color/Graphics Monitor Adaptor Card |
| (color graphics mode) |
| - IBM Color/Graphics Monitor Adaptor Card |
| (color graphics mode/mouse support) |
| - Hercules Graphics Card |
| (monochrome graphics mode) |
| - Hercules Graphics Card |
| (monochrome graphics mode/mouse support) |
| |
| Peripheral Devices Drivers: |
| - Includes all drivers that are provided in the latest |
| version of GSX-86 for the CP/M-86 family of |
| operating systems. |
| |
| o GSX-86 User's Guide (CP/M-86) V1.2 |
| |
| o GSX-86 User's Guide (DOS) V1.0 |
| |
| o GSX-86 Programmer's Guide (Generic) V1.2 |
| |
| |
| Language Binding Software and Documentation |
| ------------------------------------------------------ |
| |
| o GSX-86 Language Binding Disk (DOS) (5 1/4" DS/DD) |
| |
| - CBASIC Compiler (CB86) |
| - Pascal/MT+86 |
| - PL/I-86 |
| - Digital Research C (Small Memory Model) |
| - Digital Research C (Large Memory Model) |
| - Digital Research FORTRAN-77 (Small Memory Model) |
| - Digital Research FORTRAN-77 (Large Memory Model) |
| |
| |
| Page 10 |
| |
------------------------------------------------------------------
------------------------------------------------------------------
| CBASIC Compiler - CB86 READ.ME File Notes January 1984 |
| |
| |
| |
| o GSX-86 Language Binding Disk (CP/M-86) (5 1/4" DS/DD) |
| |
| - CBASIC Compiler (CB86) |
| - Pascal/MT-86 |
| - PL/I-86 |
| - Digital Research C (Small Memory Model) |
| - Digital Research C (Large Memory Model) |
| - Digital Research FORTRAN-77 (Small Memory Model) |
| - Digital Research FORTRAN-77 (Large Memory Model) |
| |
| o GSX-86 Programmer's Reference Language Guide (Generic) |
| |
| |
| Demonstration Software |
| ------------------------------------------------------ |
| |
| o GSX-86 Demonstration Disk (CP/M-86) (5 1/4" DS/DD) |
| |
| o GSX-86 Demonstration Disk (DOS) (5 1/4" DS/DD) |
| |
| |
| Licensing Information |
| ------------------------------------------------------ |
| |
| o Single User License |
| |
| o Redistribution License |
| |
| |
| |
| VVVVVVV |
| VVVVV |
| VVV |
| V |
| |
| END OF READ.ME FILE |
| |
| |
| |
| |
| |
| |
| Page 11 |
| |
------------------------------------------------------------------