[m-rev.] For review: README files for Java/DotNet

[Fergus Henderson]

On 27-Jan-2004, James Goddard <goddardjames at yahoo.com> wrote:
> +INTRODUCTION
> +
> +This release of Mercury contains a port to Sun Microsystems' Java 2 Platform,
> +Standard Edition (J2SE).
> +The Mercury compiler will generate Java source code that can be assembled into
> +Java bytecode suitable for running in the J2SE runtime system.

s/assembled/compiled/

> +Q. What features are not yet implemented?
> +
> +A. The following standard library modules are completely unimplemented:
> +
> +	benchmarking
> +	construct
> +	deconstruct
> +	store
> +	type_desc
> +
> +   In addition, the following individual procedures from other modules
> +   are still not yet implemented:
> +
> +	private_builtin.instance_constraint_from_typeclass_info/3
> +	private_builtin.superclass_from_typeclass_info/3
> +	private_builtin.type_info_from_typeclass_info/3
> +	private_builtin.unconstrained_type_info_from_typeclass_info/3
> +	term_size_prof_builtin.measure_size/2
> +	term_size_prof_builtin.measure_size_acc/3
> +	term_size_prof_builtin.increment_size/2
> +   	time.clocks_per_sec/0
> +	time.c_clock/3
> +	time.c_times/7

Only the last three of those are user-visible, so only those three
should be mentioned here.  For the others, you should just say that
(a) type classes are not yet fully supported
and (b) Mercury-level debugging and profiling are not yet supported
for the Java back-end.

It would be helpful to also explain here how to enable Java-level
debugging.

Otherwise, that looks great.

It would be good to mention this README.Java file on the Java back-end
section of the Mercury web site (the source is in w3/include/backends.inc).

-- 
Fergus Henderson <fjh at cs.mu.oz.au>  |  "I have always known that the pursuit
The University of Melbourne         |  of excellence is a lethal habit"
WWW: <http://www.cs.mu.oz.au/~fjh>  |     -- the last words of T. S. Garp.
--------------------------------------------------------------------------
mercury-reviews mailing list
post:  mercury-reviews at cs.mu.oz.au
administrative address: owner-mercury-reviews at cs.mu.oz.au
unsubscribe: Address: mercury-reviews-request at cs.mu.oz.au Message: unsubscribe
subscribe:   Address: mercury-reviews-request at cs.mu.oz.au Message: subscribe
--------------------------------------------------------------------------