! DECUSC.HLP Created by Martin Minow, 25-Jul-80, edited 11-Feb-82 ! Modified 11-Nov-84 by TMK for RSTS/E 8.0-07 Decus C is a PDP-11 compiler for the C language. It is distributed by Decus and is otherwise unsupported. It may be used under RSX11-M, RSTS/E, RT11, and VAX/VMS (compatibility mode). The language is generally as described in Kernighan and Ritchie's book, The C Programming Language (with several restrictions). *USAGE CC file Output from the compiler is a file in "Unix assembler format" which is assembled as follows: AS file/d The resulting .obj file is linked against the RT11 C library C:CLIB.OBJ: LINK file=file,C:SUPORT,C:CLIBN/B:2000 (no EIS) LINK file=file,C:SUPORT,C:CLIB/B:2000 (with EIS) The start address must be increased over the default to allow space for automatic variable allocation. /B:2000 is a reasonable minimum value. *SWITCHES Note the following switches: RSX RT11 -a /a Chain to AS if no errors (RSX-11M native mode only) /a may not be given from an RT11 command file. -d /d Double precision (normal) floating point -f /f Single precision (non-standard) floating point -p /p Include profile code generation *AS AS file/switches or RUN AS AS> file,list=file/switches The assembler is controlled by the following switches: RSX RT11 -b /b Flag branches that are expanded to Bxx/JMP sequences -d /d Delete the input file if no errors were encountered (normal for C assemblies). -g /g Globalize undefined symbols -l /l Explicitly generate a listing file. Under RT11 you can even write "AS file.obj,file.lst=file.s" -n /n Do not generate an object file *INVOCATION When C programs are run, a Unix-style startup sequence is emulated (including redirection of standard input and output). On RSTS/E, C programs may be invoked by using the CRUN command: CRUN PROG -switches [outfile] Note that lower-case arguments should be quoted to prevent translation by the operating system. CRUN uses a search list to locate the file, first looking in your current directory, then in your private group library, then in C:, then in PUB:, then in $. If a C program is RUN, it will prompt for an argument string: RUN PROG PROG> arguments *DOCUMENTATION The following documentation is available: c:cc.doc Compiler Usage c:as.doc Assembler Usage c:clib.doc Runtime library Usage c:cbugs.doc Current list of problems c:wizard.doc Runtime library with internal documentation (BIG!) c:tools.doc Utility programs written in C c:cookie.doc 'Fortune Cookie' program written in C