[m-rev.] for review: tighten up checks for invlaid grade in mgnuc script etc
zoltan.somogyi at runbox.com
Thu Apr 23 14:54:29 AEST 2015
On Thu, 23 Apr 2015 10:26:36 +1000 (AEST), Julien Fischer <jfischer at opturion.com> wrote:
> > and its helpers out of the user guide and into a separate document;
> > I think we can reduce confusion by moving the documentation for mmake
> Agreed. The main reason I think we haven't done that is (1) the
> replacement documentation for "mmc --make" is not really up to scratch
> and (2) a lot of the documentation for "mmc --make" is tangled up with
> that of mmake.
I agree that the documentation of grades needs to be improved, and that
this documentation should be common for mmake and mmc --make. However,
not having documentation of grades in the user guide is a bad idea.
Move it to a separate file if you must, but only if you can include a (possibly
processed) version of it in the user guide.
> > and, to a lesser degree, moving the helper scripts out of the main bin
> > directory and into lib/mercury/bin or something.
> I have an alternative suggestion, which is that we simply don't install
> mmake (and its associated dependencies) by default.
I would object to that. I still use mmake. It is still more controllable
for diagnosing problems than mmc --make.
More information about the reviews