[m-rev.] for post-commit review: proposed help text structure

Zoltan Somogyi zoltan.somogyi at runbox.com
Fri Jun 20 23:05:30 AEST 2025



On Fri, 20 Jun 2025 23:00:06 +1000, Julien Fischer <jfischer at opturion.com> wrote:

> On Fri, 20 Jun 2025 at 05:35, Zoltan Somogyi <zoltan.somogyi at runbox.com> wrote:
> >
> > This is not worth reviewing yet. What is worth reviewing is the
> > file showing the overall structure that I am proposing for help text.
> 
> > Help options
> > Options for modifying the command line
> > Options that give the compiler its overall task
> > Grade options
> > Options that control inference
> > Options specifying the intended semantics
> > Verbosity options
> > Warning options
> >     Warnings about possible incorrectness
> >     Warnings about possible performance issues
> >     Warnings about programming style
> >     Options that control warnings
> >     Options about halting for warnings
> > Options that request information
> > Options that ask for informational files
> > Controlling trace goals
> > Diagnostics options
> >     Options that control diagnostics
> >     Options that control color in diagnostics
> 
> I would be inclined to move "Diagonstics options" to
> before "Warning options"

OK, that works.

> (and at the very list to before
> "Controlling trace goals".

I presume you meant "very least"?

I will fix the spelling mistakes you pointed out.
May I presume that you found the rest of the structure
works for you?

Zoltan.



More information about the reviews mailing list