https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=292130

            Bug ID: 292130
           Summary: NO_CLEAN knob documentation vs WITH_CLEAN
           Product: Base System
           Version: 15.0-STABLE
          Hardware: Any
                OS: Any
            Status: New
          Severity: Affects Only Me
          Priority: ---
         Component: misc
          Assignee: [email protected]
          Reporter: [email protected]

In the 15.0 tree (also in main / CURRENT) the top-level Makefile.inc1 in src
(https://cgit.freebsd.org/src/tree/Makefile.inc1?h=releng/15.0) says this on
lines 4 and 481 respectively:

```
#       -DNO_CLEAN do not clean at all
.info The src.conf WITHOUT_CLEAN option can now be used instead of NO_CLEAN.
```

But the documentation for `src.conf`
(https://man.freebsd.org/cgi/man.cgi?query=src.conf&apropos=0&sektion=0&manpath=FreeBSD+15.0-RELEASE&arch=default&format=html)
only mentions a `WITH_CLEAN`, and the `UPDATING` file says (since 20240729)
that no-clean is the default these days.

The documentation ought to be consistent; I think that means that the
Makefile.inc1 should not mention NO_CLEAN or WITHOUT_CLEAN, but possibly add a
line in the documentation section at the top saying "WITH_CLEAN=yes clean the
object directory before starting".

-- 
You are receiving this mail because:
You are the assignee for the bug.

Reply via email to