From owner-freebsd-doc@FreeBSD.ORG Thu Apr 17 15:20:14 2003 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 6246037B401 for ; Thu, 17 Apr 2003 15:20:14 -0700 (PDT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id EC75743F85 for ; Thu, 17 Apr 2003 15:20:12 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h3HMKCUp031932 for ; Thu, 17 Apr 2003 15:20:12 -0700 (PDT) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h3HMKCUv031931; Thu, 17 Apr 2003 15:20:12 -0700 (PDT) Resent-Date: Thu, 17 Apr 2003 15:20:12 -0700 (PDT) Resent-Message-Id: <200304172220.h3HMKCUv031931@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Martin Karlsson Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 3B8EC37B407 for ; Thu, 17 Apr 2003 15:18:57 -0700 (PDT) Received: from mf1.bredband.net (mf1.bredband.net [195.54.106.36]) by mx1.FreeBSD.org (Postfix) with ESMTP id A604F43FBD for ; Thu, 17 Apr 2003 15:18:53 -0700 (PDT) (envelope-from martink@shell.linux.se) Received: from localhost.036-23-6f72652.cust.bredbandsbolaget.se ([213.112.193.73]) by mf1.bredband.net with ESMTP <20030417221852.CEXZ269.mf1@localhost.036-23-6f72652.cust.bredbandsbolaget.se> for ; Fri, 18 Apr 2003 00:18:52 +0200 Received: from c-49c170d5.036-23-6f72652.cust.bredbandsbolaget.se (localhost [127.0.0.1])with ESMTP id h3HMH3xJ094290 for ; Fri, 18 Apr 2003 00:18:25 +0200 (CEST) martink@c-49c170d5.036-23-6f72652.cust.bredbandsbolaget.se) Received: (from martink@localhost) (8.12.9/8.12.9/Submit) id h3HMGV35094287; Fri, 18 Apr 2003 00:16:31 +0200 (CEST) (envelope-from martink) Message-Id: <200304172216.h3HMGV35094287@c-49c170d5.036-23-6f72652.cust.bredbandsbolaget.se> Date: Fri, 18 Apr 2003 00:16:31 +0200 (CEST) From: Martin Karlsson To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/51109: [PATCH] handbook (kernelconfig) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Martin Karlsson List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 17 Apr 2003 22:20:14 -0000 >Number: 51109 >Category: docs >Synopsis: [PATCH] handbook (kernelconfig) >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Thu Apr 17 15:20:12 PDT 2003 >Closed-Date: >Last-Modified: >Originator: Martin Karlsson >Release: FreeBSD 5.0-CURRENT i386 >Organization: >Environment: System: FreeBSD c-49c170d5 5.0-CURRENT FreeBSD 5.0-CURRENT #0: Thu Apr 17 07:40:57 CEST 2003 root@c-49c170d5:/usr/obj/usr/src/sys/K20030417 i386 >Description: The handbook does explain how to copy GENERIC to MYKERNEL, and edit MYKERNEL, but does not explicitly mention why editing GENERIC directly is a bad idea. Perhaps it should? This patch aims to fix that. I have seen related questions (Where did GENERIC go?) on -questions only a few times, but being explicit about important things is rarely bad IMO. >How-To-Repeat: Read the handbook, 9.3 Building and Installing a Custom Kernel. >Fix: --- kernelconfig.diff begins here --- Index: chapter.sgml =================================================================== RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/kernelconfig/chapter.sgml,v retrieving revision 1.104 diff -u -r1.104 chapter.sgml --- chapter.sgml 2003/03/31 17:01:34 1.104 +++ chapter.sgml 2003/04/17 21:55:17 @@ -186,6 +186,13 @@ call it MYKERNEL for the purpose of this example. + + Do not simply edit GENERIC. + If you do, it will be overwritten the next time you update your source tree, and all + your kernel modifications will be lost. + + Storing your kernel config file directly under /usr/src can be a bad idea. If you are --- kernelconfig.diff ends here --- >Release-Note: >Audit-Trail: >Unformatted: