[Bug 273195] FreeBSD Handbook: occasionally building a kernel module using both /usr/ports and /usr/src

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

            Bug ID: 273195
           Summary: FreeBSD Handbook: occasionally building a kernel
                    module using both /usr/ports and /usr/src
           Product: Documentation
           Version: Latest
          Hardware: Any
                OS: Any
            Status: New
          Severity: Affects Many People
          Priority: ---
         Component: Books & Articles
          Assignee: doc@FreeBSD.org
          Reporter: grahamperrin@freebsd.org

It's sometimes – not always – necessary to build a ported kernel module from
source, after a minor update to the operating system. 

It's sometimes necessary to build a ported kernel module from source, after
simply installing (not updating) the OS. 

Recent
<https://github.com/freebsd/freebsd-src/commit/9051987e40c5a1f2396c5ceecff119fb4da28160#diff-7a99811ebf6b6268a2581fcf050df0a2c325fdbf1c02481dad16afd38f4bd6a1>
on the main branch (for CURRENT) was an extraordinary change. From the commit
message: 

> … Out-of-tree kernel modules will need to be rebuilt.

----

As far as I can tell, <https://docs.freebsd.org/en/books/handbook/ports/> does
not yet cover the commonplace use cases. 

Elsewhere in the FreeBSD Handbook, parts of
<https://docs.freebsd.org/en/books/handbook/cutting-edge/#makeworld> are
misplaced; should probably be moved to a new chapter. 

From <https://old.reddit.com/r/freebsd/comments/15gssd3/-/jvpfm8h/?context=1>: 

> - you're packaging and installing a port
> 
> - you're neither updating, nor upgrading, the operating system.
> 
> Other problems around this subsection:
> 
> 1. the first sentence of 
> <https://docs.freebsd.org/en/books/handbook/book/#updating-src-preparing> 
> begins with direction to read /usr/src/UPDATING, which does not exist 
> because the copy of the source code has not been obtained (disorderly)
> 
> 2. then updating before obtaining (again, disorderly)
> 
> …

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