[m-rev.] for post-commit review: document the .target_debug and .pregen grade modifiers

[Zoltan Somogyi]

On Mon, 11 Aug 2025 14:16:37 +1000, Julien Fischer <jfischer at opturion.com> wrote:
> On Sun, 10 Aug 2025 at 22:09, Zoltan Somogyi <zoltan.somogyi at runbox.com> wrote:
> > +This grade modifier is applicable
> > +only to the base grades @code{hlc} and @code{none}.
> 
> No, it is applicable to all LLDS base grades. For .pregen grades, as
> normally, the
> details of which base grade is used are abstracted by macros in the
> generated code.
> (Values from the configure script determine how those macos are expanded.)

The next three commented out lines acknowledge that, and also say
why I intentionally left out reg and asm_fast :-(

> All that said, the chances of the source distributions moving off hlc are
> pretty much zero at this point.

And that was the other reason for not documenting reg/asm_fast.

I followed your other suggestions.

Zoltan.