[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