/*

File	: README
Purpose	: Doc about this distribution
Date	: Feb 13 '92
By	: noud
Email	: noud@dutentc.et.tudelft.nl

*/

!! You only need this, if you are interested in porting programs to
   or from Coherent Mark Williams C. If you have nothing to with this, 
   don't waste your time.
!!

 The files in this package are :

	README		- This file (you're reading it)

	rprintf.doc	- Doc about r*printf routines for export from Coherent
	vprintf.doc	- Doc about v*printf routines for import to Coherent
	Makefile	- Library making makefile

	rprintf.c	- printf with recursive formats for non Coherent sys's
	rsprintf.c	- sprintf with ...
	rfprintf.c	- fprintf ...
	prpatch.h	- Defines for exporting Coherent programs

	vp_frame.c	- lower routine, called by v*printf
	vprintf.c	- variable argument printf
	vsprintf.c	- variable argument sprintf
	vfprintf.c	- variable argument fprintf

	varargs.h	- variable argument header by David Fenyes

This package is created to solve a problem with Coherent 3.10.
First, Coherent doesn't have a variable argument header. This can be solved
with a header created by David Fenyes, which is also included into this
package. If you didn't already have this header, copy it to your 
/usr/include directory.

 But also the v*printf family of variable argument printf routines
is missing. This package makes a library with these routines for Coherent.
Coherent has a circumvention for these routines, so that you don't need
these routines at all, this is called "recursive formatting".

Now you can be faced with the problem of exporting programs from Coherent
(as I was) to a general Unix or importing programs to Coherent with these
different approaches. So I wrote a set of *printf routines which allow for
recursive formatting on non-Coherent systems using v*printf routines and
I wrote a set of v*printf routines for Coherent systems using the recursive
formats of the *printf routines of Coherent. Just for import/export purposes.

For exporting programs from Coherent to a General Unix see rprintf.doc
command : "make noncoherent" (on the target machine)
This makes the library librprintf.a, which can be used to link all 
*printf calls from your Coherent program to their r*printf counterparts.

For importing programs from a General Unix to Coherent see vprintf.doc
command : "make coherent" (on your coherent machine)
This makes the library libvprintf.a, which can be used to link all
v*printf calls from non Coherent programs with.

