[Bug 278441] makeman generates misleading text for BROKEN_OPTIONS

From: <bugzilla-noreply_at_freebsd.org>
Date: Thu, 18 Apr 2024 18:12:14 UTC
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=278441

            Bug ID: 278441
           Summary: makeman generates misleading text for BROKEN_OPTIONS
           Product: Documentation
           Version: Latest
          Hardware: Any
                OS: Any
            Status: New
          Severity: Affects Only Me
          Priority: ---
         Component: Manual Pages
          Assignee: bugs@FreeBSD.org
          Reporter: brooks@FreeBSD.org
                CC: doc@FreeBSD.org

When the NVME option was marked broken on some architectures, makeman produced
the following text in src.conf.5 which is misleading:

.It Va WITHOUT_NVME
Do not build nvme related tools and kernel modules.
.Pp
This is a default setting on
arm/armv7, powerpc/powerpc and riscv/riscv64.
.It Va WITH_NVME
Build nvme related tools and kernel modules.
.Pp
This is a default setting on
amd64/amd64, arm64/aarch64, i386/i386, powerpc/powerpc64 and
powerpc/powerpc64le.

The problem is that WITHOUT_NVME isn't the default on those architectures, it's
that setting WITH_NVME has no effect.  makeman probably needs to grow direct
support for BROKEN_OPTIONS.

-- 
You are receiving this mail because:
You are on the CC list for the bug.