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

[David Overton]

On Fri, Aug 25, 2000 at 05:15:56PM +1000, Fergus Henderson wrote:
> 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.

I think it would also be useful to have the table sorted by operator precedence.


David
-- 
David Overton      Department of Computer Science & Software Engineering
PhD Student        The University of Melbourne, Victoria 3010, Australia
+61 3 8344 9159    http://www.cs.mu.oz.au/~dmo
--------------------------------------------------------------------------
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
--------------------------------------------------------------------------