bin/46067: savecore(8) man page fails to document kernel fakery

[gson%gson.org@localhost (Andreas Gustafsson)]

>Number:         46067
>Category:       bin
>Synopsis:       savecore man page fails to document kernel fakery
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    bin-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Tue Feb 21 19:25:00 +0000 2012
>Originator:     Andreas Gustafsson
>Release:        NetBSD-current
>Organization:
>Environment:
System: NetBSD
Architecture: i386
Machine: i386
>Description:
        
In 2008, savecore(8) was changed such that it no longer saves an
actual kernel, but a "fake" kernel containing only the kernel symbols.
However, this change was never documented; the savecore(8) man page
still claims it saves "the kernel".

>How-To-Repeat:

Try to debug a crash dump.  Notice strange differences between the
so-called "kernel" saved by savecore and the actual kernel.  Become
confused.

>Fix:

Document the fakery, or revert savecore to the documented behavior.