[m-dev.] for review: add operators to reference manual

[Fergus Henderson]

On 25-Aug-2000, David Glen Jeffery <dgj at students.cs.mu.oz.au> wrote:
> 
> Add the list of valid operators to the reference manual.
> 
> doc/reference_manual.texi:
> 	Add a table of valid operators.
> library/ops.m:
> 	Add a note indicating that reference_manual.texi needs to be kept
> 	in sync with the operator table.

This change is a definite improvement on the current status quo.
However, it could be improved still further:

	- the "Terms:" section should contain a forward reference
	  to the "Operators:" section

	- the "Operators:" section should explain what the specifiers
	  (e.g. "fx", "xfy", "fxy") mean, and what the numbers in the
	  "Priority" column mean.

	- for the operators which `library/ops.m' documents as `NYI'
	  (`import_*', `export_*', and `use_*'), I think it would be
	  better not to document them here.  Currently they are not
	  used at all, and they're not likely we could even just comment
	  out those lines in library/ops.m.

Cheers,
	Fergus.

-- 
Fergus Henderson <fjh at cs.mu.oz.au>  |  "I have always known that the pursuit
WWW: <http://www.cs.mu.oz.au/~fjh>  |  of excellence is a lethal habit"
PGP: finger fjh at 128.250.37.3        |     -- the last words of T. S. Garp.
--------------------------------------------------------------------------
mercury-developers mailing list
Post messages to:       mercury-developers at cs.mu.oz.au
Administrative Queries: owner-mercury-developers at cs.mu.oz.au
Subscriptions:          mercury-developers-request at cs.mu.oz.au
--------------------------------------------------------------------------