* *   D e c u s C   o n   t h e   E n e t   * *

        REX::DECUSC$LIBRARY:*.* is the EXECUTABLE DECUSC distribution
for VMS compatibility mode.  (See below for P/OS, RSTS/E and RT11.)
         
	The toplevel directory (DECUSC executable package) is available for
copying over the net 24 hours a day, seven days a week.   This is about
5,000 blocks.

	The sources and PRO/350 kit files are stored in subdirectories.
To locate these directories, do the following:

	$ file = f$search("REX::DECUSC$LIBRARY:*.*;*")
	$ prefix = f$parse(file,,,"NODE")+f$parse(file,,,"DEVICE") -
	         + f$parse(file,,,"DIRECTORY") - "]"
	$ copy 'prefix'.TOOLS]*.* [YOURTOOLS]		! etc.

	To reduce network load during Prime Time, everything below
the toplevel directory is available for copying over the net ONLY between
18:00-08:00 hours Monday through Thursday AND 18:00 Friday through 08:00
Monday. Feel free to push in a batch job during those hours and pick up the
entire distribution, this is about 25,000 blocks!

Binary "kit":	Copy only the top-level directory [DECUSC].
		Delete *.DIR and XCOMLB.OLB
		See "installation" notes, below.

Source "kit:"	Copy the following sub-directories as needed.
	** NOTE: sub-directories may not be copied during	**
	** prime-time in Maynard (0800-1800).			**

  documentation	[.COMMAND]  (also has .h masters, .rno, and other stuff)
  compiler	[.COMP]
  run-time	[.OTSCOM] and [.OTSIO]
  tools		[.TOOLS]
  misc. progs.	[.MISC]   (generally un-needed)
  lex		[.LEX]    (lexical analyser generator)
  RSX library	[.RSXLIB] (allows access to rsx directives from C)
  RSTS library	[.RSTSLB] (allows access to rsts directives from C)
  VAX library	[.VAXLIB] (for running Decus C stuff on Vax-11 C)
  stuff		[.USEFUL] (sometimes useful subroutines)
  math library	[.PML]    (portable math library)
  cross asm's	[.CROSS]  (for various micros)
  PRO-350 kit	[.POS...] (see below)

See KIT.DOC for more details.

To use Decus C on vms, add the following to your LOGIN.COM file,
changing the disk assignments as needed.

	$ ASSIGN	Your_disk:[decusc]	c
	$ XCC		:== $C:CC.EXE
	$ XAS		:== $C:AS.EXE

To compile a file,

	XCC filenam
	XAS filename -d		(assember)

To taskbuild a file (vax compatibility)

	MCR TKB filename,c:c/lb

See the command files in [.TOOLS] for other examples.

Please note:  Decus C is a "hobby" -- it is not supported product.
If you have trouble installing the system, read the manual.
If you find a bug, fix it and then contact me.

** PRO-350 P/OS

If you want Decus C for a Pro-350 (with the native toolkit installed),
First, copy the following from REX::SYS$SYSDEVICE:[DECUSC.POS]:

CC.TSK, AS.TSK			copy to APPL$DIR: on the PRO
C.OLB, CRPRO.OLB, CX.OLB	copy to LB:[1,5] on the PRO

Next, create a directory [ZZDECUSC] and copy the header files

[DECUSC]*.H			copy to [ZZDECUSC] on the PRO.
[DECUSC.POS.ZZDECUSC]*.H	copy to [ZZDECUSC] on the PRO.

Then, add the following to your START.CMD file

	.ifnins ...XAS	install appl$dir:XAS/task=...XAS
			assign lb:[1,5]	c:

Usage on the PRO:

	$ run $cc/command="cc yourfile -a"	compile, then assemble
	$ link yourfile,c:c/lib			link

The libraries are as follows:

C.OLB		FCS style I/O
CRPRO.OLB	RMS style I/O
CX.OLB		RSX-11M Executive Services library

Documentation is stored on REX::SYS$SYSDEVICE:[DECUSC] --

CC.DOC		Compiler
WIZARD.DOC	Full library documentation, including internals
CX.DOC		RSX-11M executive services

** RSTS/E and RT-11

PRINCE::C:	Contains a binary kit (that is slightly out of date).
		Since RSTS/E doesn't let you copy executable files,
		the .SAV files have also been stored (with the
		"executable" bit turned off) in PRINCE::DSKZ:[5,0]

** Support

None: if you fix something, please let me know.

Martin Minow
REX::MINOW	decvax!minow	DTN 223-9922, (617) 493-9922