[m-rev.] for review: update backends page on website

Zoltan Somogyi zoltan.somogyi at runbox.com
Wed Jan 19 19:16:25 AEDT 2022



On Wed, 19 Jan 2022 19:07:25 +1100 (AEDT), Julien Fischer <jfischer at opturion.com> wrote:
> > The C# and Java backends say that there is support for
> > Mercury level debugging, but the .ssdebug grade component,
> > as far as I remember, is not actually publically documented,
> > which makes these claims look hollow.
> 
> I think those descriptions were written before we un-publicly
> documented the .ssdebug grades.

I have never used the .ssdebug grades, so I don't know what
their state is. Should we document them, limitations and all,
or delete the reference in backends.inc?

> > I am not sure why we lay so much (relative) emphasis
> > on good interfacing with the target language. Shouldn't this be
> > a given?
> 
> It should, but it doesn't hurt to emphasise it since it's something
> prospective users of Mercury may well be interested in.

I note that we do NOT emphasize interfacing for the C backends.
And for people for whom this is an important point, noting it once,
for all backends, at the start, would be harder to miss.
 
> > Does anyone have a list of the parts of the standard library
> > that do not work in Java and/or C# grades?
> 
> They are listed in REAMDE.{Java,CSharp} and/or described in the
> library documentation itself.

In that case, please reword that sentence, possibly after moving it
to *after* the reference to README.{Java,Csharp}.

> > Why is it important to specify the first release that supported
> > these backends? These were more than a decade ago.
> 
> Those descriptions were added to accompany the first release
> supporting the backends.  (I don't think this page has been updated
> since then.)  We should remove them, since the C# and Java backends
> *are* supported in any release of Mercury that will get past the
> configure step these days.

I have deleted them.

> > Note that my laptop does not have PHP installed,
> > so I haven't been able to test the aesthetics of the result.
> 
> I'll take a look after you commit and make any adjustments required.

Committed. Thanks.

Zoltan.


More information about the reviews mailing list