|
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: 8960 (0x2300)
Types: TextFile
Names: »READ.ME«
└─⟦fa5b86546⟧ Bits:30002725 SW1609 Digital Research C - CCP/M - Oct 83
└─ ⟦this⟧ »READ.ME«
----------------------------------------------------------------
ø ø
ø ø
ø ø
ø ø
ø ================================================ ø
ø ø ø ø
ø ø ø ø
ø ø ***** Digital Research C ***** ø ø
ø ø ø ø
ø ø for the CP/M-86 Family ø ø
ø ø of Operating Systems ø ø
ø ø ø ø
ø ø --------------- ø ø
ø ø ø ø
ø ø READ.ME File Notes ø ø
ø ø ø ø
ø ø - November 1983 - ø ø
ø ø ø ø
ø ø 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.1 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 October 1983 ø
ø ø
ø ø
ø 1. The following rule applies to any assembly ø
ø language routine designed to interface with a ø
ø small model 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. ø
ø ø
ø 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 October 1983 ø
ø ø
ø ø
ø ø
ø 5. You can specify a user number in addition to a ø
ø drive specification in a reference to a filename. ø
ø filename as shown in the following example. ø
ø ø
ø f=open("3A:foobar.c",read); ø
ø ø
ø 6. 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. ø
ø ø
ø 7. 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 The rename function uses two string arguments. ø
ø ø
ø rename(file1, file2) ø
ø ø
ø The first argument (file1) is the file to rename. ø
ø The second argument (file2) is the new file name. ø
ø ø
ø 8. 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();å ø
ø ø
ø 9. 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. ø
ø ø
ø Page 2 ø
ø ø
----------------------------------------------------------------
----------------------------------------------------------------
ø Digital Research C READ.ME File Notes October 1983 ø
ø ø
ø ø
ø ø
ø 10. The -c and -m options for compact and medium ø
ø model compilation are no longer supported. ø
ø ø
ø 11. The compiler treats pointers in a big model ø
ø program as long integers. This can produce ø
ø incorrect results if not used with caution. ø
ø ø
ø ø
ø VVVVVVV ø
ø VVVVV ø
ø VVV ø
ø V ø
ø ø
ø END of READ.ME FILE ø
ø ø
ø ø
ø ø
ø ø
ø ø
ø ø
ø ø
ø ø
ø ø
ø ø
ø ø
ø ø
ø ø
ø ø
ø ø
ø ø
ø ø
ø ø
ø ø
ø ø
ø ø
ø ø
ø ø
ø ø
ø ø
ø ø
ø ø
ø ø
ø Page 3 ø
ø ø
----------------------------------------------------------------
«eof»