NetBSD Problem Report #57873

From www@netbsd.org  Tue Jan 23 21:49:42 2024
Return-Path: <www@netbsd.org>
Received: from mail.netbsd.org (mail.netbsd.org [199.233.217.200])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits))
	(Client CN "mail.NetBSD.org", Issuer "mail.NetBSD.org CA" (not verified))
	by mollari.NetBSD.org (Postfix) with ESMTPS id 137F11A9238
	for <gnats-bugs@gnats.NetBSD.org>; Tue, 23 Jan 2024 21:49:42 +0000 (UTC)
Message-Id: <20240123214940.B537C1A9239@mollari.NetBSD.org>
Date: Tue, 23 Jan 2024 21:49:40 +0000 (UTC)
From: campbell+netbsd@mumble.net
Reply-To: campbell+netbsd@mumble.net
To: gnats-bugs@NetBSD.org
Subject: Guide suggests manual kernel build before build.sh
X-Send-Pr-Version: www-1.0

>Number:         57873
>Category:       misc
>Synopsis:       Guide suggests manual kernel build before build.sh
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    misc-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Tue Jan 23 21:50:00 +0000 2024
>Originator:     Taylor R Campbell
>Release:        current
>Organization:
The Build.sh Foundation
>Environment:
>Description:
For some reason the NetBSD Guide prioritizes a bunch of detailed instructions about how to manually build a kernel by running config and make yourself, out of a read/write source tree:

https://www.netbsd.org/docs/guide/en/chap-build.html#chap-boot-cross-config-kernel

This should be relegated to a separate section that comes later, and the guide should start front and center with just:

./build.sh ... tools kernel=GENERIC

This should come before any piles of prose get in the way of building your kernel.
>How-To-Repeat:
read the guide
>Fix:
Yes, please!

Home	PR Database Search