! 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 [<infile] [>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
