Re: git: c581962414ed - main - src.conf.5: Add some WITH_/WITHOUT_ option descriptions

On Wed, 8 Mar 2023 at 18:34, John Baldwin <jhb@freebsd.org> wrote:
>
> On 3/8/23 3:31 PM, Ed Maste wrote:
> > The branch main has been updated by emaste:
> >
> > URL: https://cgit.FreeBSD.org/src/commit/?id=c581962414edfc26796319ccc988647b08b03ce1
> >
> > commit c581962414edfc26796319ccc988647b08b03ce1
> > Author:     Ed Maste <emaste@FreeBSD.org>
> > AuthorDate: 2023-03-07 18:49:23 +0000
> > Commit:     Ed Maste <emaste@FreeBSD.org>
> > CommitDate: 2023-03-08 23:30:45 +0000
> >
> >      src.conf.5: Add some WITH_/WITHOUT_ option descriptions
> >
> >      Reviewed by:    markj, brooks
> >      Sponsored by:   The FreeBSD Foundation
> >      Differential Revision: https://reviews.freebsd.org/D38961
>
> Hah, I was just working on those, but I noticed that we don't have
> duplicate WITH/WITHOUT options for other options so kind of punted.

We already had (some) duplicates for options which have different
defaults per architecture, like LLDB. These ones (plus
WITH_LOADER_VERIEXEC_VECTX) were the only ones missing when running
`make makeman`.

I think there is some value to providing the list of architectures for
WITH_ and WITHOUT_ defaults. Perhaps we could rework makeman to look
also for a single option description (without WITH_/WITHOUT_ prefix),
producing something like:

WITH_LLDB / WITHOUT_LLDB
        Control building of the LLDB debugger.

        WITH_LLDB is the default setting on amd64/amd64, arm64/aarch64,
        i386/i386, powerpc/powerpc and powerpc/powerpc64.

        WITHOUT_LLDB is the default setting on arm/armv6, arm/armv7, mips/mips,
        mips/mips64, riscv/riscv64 and riscv/riscv64sf.