dos_compilers/Digital Research CB-86 v2/READ.ME2
2024-06-30 11:56:20 -07:00

852 lines
26 KiB
Plaintext
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

------------------------------------------------------------------
| |
| |
| |
| |
| ================================================ |
| | | |
| | | |
| | ***** 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 |
| |
------------------------------------------------------------------