|
DataMuseum.dkPresents historical artifacts from the history of: CP/M |
This is an automatic "excavation" of a thematic subset of
See our Wiki for more about CP/M Excavated with: AutoArchaeologist - Free & Open Source Software. |
top - download
Length: 10496 (0x2900)
Types: TextFile
Names: »READ.ME«
└─⟦93c4d868c⟧ Bits:30005869 SW1609 Digital Research C v. 1.11 - May 84
└─ ⟦this⟧ »READ.ME«
└─⟦b85731168⟧ Bits:30002664 Digital Research C - CCP/M - May 84
└─ ⟦this⟧ »READ.ME«
------------------------------------------------------------------ ø ø ø ø ø ø ø ø ø ================================================ ø ø ø ø ø ø ø ø ø ø ø ***** Digital Research C ***** ø ø ø ø ø ø ø ø for the CP/M-86 Family of ø ø ø ø Operating Systems ø ø ø ø ø ø ø ø --------------- ø ø ø ø ø ø ø ø READ.ME File Notes ø ø ø ø ø ø ø ø - May 1984 - ø ø ø ø ø ø ø ø Digital Research Inc. ø ø ø ø P.O. Box 579 ø ø ø ø Pacific Grove, CA 93950 ø ø ø ø ø ø ø ================================================ ø ø ø ø ø ø ø ø This file presents enhancements and modifications ø ø made to Digital Research C Language software and ø ø documentation. Changes described in this file ø ø apply to Digital Research C compiler software ø ø Version 1.11 and the "C Language Programmer's Guide ø ø for the CP/M-86 family of operating systems. ø ø Second Edition: October 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. ø ø ø ø ø ø ø ø ø ø ø ø ø ø ø ø ø ø ø ø ø ------------------------------------------------------------------ ------------------------------------------------------------------ ø Digital Research C READ.ME File Notes May 1984 ø ø ø ø ø ø 1. The following rules apply to any assembly ø ø language routine designed to interface with a ø ø C program. ø ø ø ø o If the assembly program alters values in the ES ø ø register, you must save the original value in ES ø ø upon entry to the routine. You must restore the ø ø original ES value upon exit from the routine. If ø ø you call a C function from the assembly routine, ø ø you must restore the original ES before the call. ø ø This applies for small model C programs only. ø ø ø ø o If your program sets the direction flag, you must ø ø clear it upon exit from the routine. ø ø ø ø 2. The C compiler now has two additional command ø ø line options. ø ø ø ø o Use the -E option to change the maximum number of ø ø errors the compiler detects before stopping the ø ø compilation. The default is 10 errors. ø ø The following example changes the maximum number ø ø of errors to 25. ø ø ø ø B>DRC PROGRAM -E25 ø ø ø ø o Use the -S option to reduce the size of the ø ø symbol table by truncating symbolic names during ø ø compilation. Specify a length after the -S as ø ø shown in the following example. In this example, ø ø all symbolic names are truncated to 8 characters. ø ø ø ø B>DRC PROGRAM -S8 ø ø ø ø 3. Symbolic names are now significant up to forty ø ø (40) characters instead of eight (8). Use the -S ø ø option to reduce the symbol table size when ø ø compiling large programs that use lengthy names. ø ø ø ø 4. The compiler displays a warning message if your ø ø program attempts to compute the address (&) of a ø ø register variable. ø ø ø ø Page 1 ø ø ø ------------------------------------------------------------------ ------------------------------------------------------------------ ø Digital Research C READ.ME File Notes May 1984 ø ø ø ø ø ø ø ø 5. You can create overlays that either accumulate ø ø or overlay the data in various overlays. Use the ø ø LINK86 CUM option to specify cumulative data. ø ø Use the LINK86 NOCUM option to specify ø ø non-cumulative data. Overlays on the same level ø ø share data areas. ø ø ø ø 6. The C compiler has three additional library ø ø functions: readl, writel, and rename. ø ø ø ø o The readl function is just like the read function ø ø except readl uses a long int argument and returns ø ø a long int value. ø ø ø ø o The writel function is just like the write ø ø function except that it uses a long int argument ø ø and returns a long int value. ø ø ø ø o Use the rename function to change the name of a ø ø file. This function uses two parameters as shown ø ø in the following syntax specification. ø ø ø ø rename(oldname,newname) ø ø ø ø The rename function returns a 1 if successful and ø ø a 0 if the file has a Read/Only status or does ø ø not exist. ø ø ø ø 7. If you mix a C program with assembly language ø ø routines, your main program must be a C function ø ø to initialize the C environment. This only ø ø requires a few extra bytes of space as shown in ø ø the following example. ø ø ø ø main()æmaina86();å ø ø ø ø 8. The -X option has been disabled because the size ø ø of the inline code that saves and restores ø ø registers in an assembly routine call is smaller. ø ø ø ø 9. The -c and -m options for compact and medium ø ø model compilation are no longer supported. ø ø ø ø Page 2 ø ø ø ------------------------------------------------------------------ ------------------------------------------------------------------ ø Digital Research C READ.ME File Notes May 1984 ø ø ø ø ø ø ø ø 10. This and previous versions of DRC do not support ø ø the enumeration data type. ø ø ø ø 11. When using the -f switch for compiling programs, ø ø functions returning a floating point value must be ø ø declared as 'double' instead of 'float'. ø ø ø ø 12. In addition to the I/O redirection operators < and ø ø >, the Run-time library functions now support the ø ø following features. ø ø ø ø o Strings enclosed in quotation marks are grouped as ø ø one argument. ø ø ø ø o Wildcard expansion. All argument strings that ø ø contain a question mark or an asterisk and not ø ø enclosed in quotation marks are wildcard file ø ø specifications. Such an argument can be replaced ø ø by all filenames in the current directory that ø ø match the filespec. The following example lists ø ø all files with a .c filetype. ø ø ø ø echo *.c ø ø ø ø If no files in the directory match the wildcard ø ø file specification, the compiler produces a ø ø message as shown below. ø ø ø ø *.c: No match ø ø ø ø o Append to an existing file operator, >>. The ø ø following example demonstrates the use of this ø ø operator. ø ø ø ø cat file1 > out.1 ø ø cat file2 >> out.1 ø ø ø ø The preceeding statements are equivalent to the ø ø following statement. ø ø ø ø cat file1 file2 > out.1 ø ø ø ø ø ø ø ø Page 3 ø ø ø ------------------------------------------------------------------ ------------------------------------------------------------------ ø Digital Research C READ.ME File Notes May 1984 ø ø ø ø ø ø 13. A minimum 192K of random access memory is ø ø recommended to operate the C compiler. ø ø ø ø 14. The command line example for reverse preprocessor ø ø operation on page 2-16 of the Programmer's Guide ø ø should read as follows. ø ø ø ø B>DRC CTEMP.TOK ø ø ø ø 15. Note that the __BDOS function described on page ø ø 3-4 of the Programmer's Guide uses a "double" ø ø underscore character. It is easy to mistake it ø ø for a single underscore. ø ø ø ø 16. The first line of the sample program, OVERLAY1.C, ø ø on page 7-3 of the Programmer's Guide does not ø ø need the semi-colon. The line should read as ø ø follows: overlay1(s) ø ø ø ø 17. Note that the compiler command line options -R and ø ø -A described in Section 2.1.3 of the Programmer's ø ø Guide are mutually exclusive. This means that ø ø when you specify one option, the other is ø ø automatically canceled. ø ø ø ø 18. There is an additional compiler command line ø ø option that is not documented in the Programmer's ø ø Guide. The -4 option directs the compiler to ø ø search a specified drive for the DRC.ERR file. ø ø The following example directs the compiler to ø ø search drive d: for DRC.ERR. ø ø ø ø B>DRC PROGRAM -4d: ø ø ø ø 19. There is a preferred procedure you must follow if ø ø you encounter an "Internal Compiler Error" when ø ø using Digital Research C. ø ø ø ø After determining how you produced the internal ø ø error, reproduce the error in a small sample ø ø program. Submit the sample to the Digital ø ø Research Technical Support Center by mail. If the ø ø sample is more than 10 lines long, submit the code ø ø on diskette. ø ø ø ø Page 4 ø ø ø ------------------------------------------------------------------ «eof»