Bug 269762 - config(8): DEBUG KERNELS section needs updating/removal
Summary: config(8): DEBUG KERNELS section needs updating/removal
Status: Open
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Some People
Assignee: freebsd-bugs (Nobody)
URL: https://github.com/freebsd/freebsd-sr...
Keywords: needs-patch
Depends on:
Blocks:
 
Reported: 2023-02-22 19:01 UTC by Mitchell Horne
Modified: 2023-03-08 15:09 UTC (History)
2 users (show)

See Also:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Mitchell Horne freebsd_committer freebsd_triage 2023-02-22 19:01:44 UTC 
The text in this section has rotted quite a bit.
 - "building a debug kernel is not the default with FreeBSD" -- this is not true even for GENERIC-NODEBUG. We always build with debugging symbols and strip them to the separate kernel.debug
 - Various mentions of disk/memory usage are way too small and should be dropped.
 - We are too far into the present to be talking about "Traditional BSD kernels" or 4.4BSD-Lite kernels in this page.

In my estimation, removal is more appropriate at this point. Even with up-to-date information, I don't know how much value it really provides in this era where kernel build/install is wrapped by buildkernel and installkernel.

https://man.freebsd.org/cgi/man.cgi?query=config&apropos=0&sektion=0&manpath=FreeBSD+14.0-CURRENT&arch=default&format=html
Comment 2 Ed Maste freebsd_committer freebsd_triage 2023-03-08 15:09:40 UTC 
I agree that the section ought to be removed, although I would probably add a little bit of information to the -g option.