From owner-freebsd-doc  Fri Jul 14  6:57: 0 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from scientia.demon.co.uk (scientia.demon.co.uk [212.228.14.13])
	by hub.freebsd.org (Postfix) with ESMTP
	id 8F73637C745; Fri, 14 Jul 2000 06:56:45 -0700 (PDT)
	(envelope-from ben@scientia.demon.co.uk)
Received: from strontium.scientia.demon.co.uk ([192.168.91.36] ident=exim)
	by scientia.demon.co.uk with esmtp (Exim 3.15 #1)
	id 13D5Qn-00043e-00; Fri, 14 Jul 2000 14:23:05 +0100
Received: (from ben) by strontium.scientia.demon.co.uk (Exim 3.15 #1)
	id 13D5Qn-000CnE-00; Fri, 14 Jul 2000 14:23:05 +0100
Date: Fri, 14 Jul 2000 14:23:05 +0100
From: Ben Smithurst <ben@FreeBSD.org>
To: Nik Clayton <nik@freebsd.org>
Cc: Greg Lehey <grog@lemis.com>, doc@FreeBSD.ORG
Subject: Re: small update to handbook about debug kernels
Message-ID: <20000714142305.R48641@strontium.scientia.demon.co.uk>
References: <20000711131846.L11000@strontium.scientia.demon.co.uk> <20000712103922.A29642@wantadilla.lemis.com> <20000712145451.D11000@strontium.scientia.demon.co.uk> <20000713010635.A11472@kilt.nothing-going-on.org>
Mime-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-md5;
	protocol="application/pgp-signature"; boundary="2qwbT0JTInWqknst"
Content-Disposition: inline
User-Agent: Mutt/1.2i
In-Reply-To: <20000713010635.A11472@kilt.nothing-going-on.org>
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org


--2qwbT0JTInWqknst
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

Nik Clayton wrote:

> Yes.  But wrap it in "<tip>...</tip>".

just to confirm, you mean all that text, like this:

+    <tip>
+      <para>If you are using FreeBSD 3 or earlier, you should make a strip=
ped
+        copy of the debug kernel, rather than installing the large debug
+        kernel itself:</para>
+
+      <screen>&prompt.root; <userinput>cp kernel kernel.debug</userinput>
+&prompt.root; <userinput>strip -g kernel</userinput></screen>
+
+      <para>This stage isn't necessary, but it is recommended.  (In
+        FreeBSD 4 and later releases this step is performed automatically
+        at the end of the kernel <command>make</command> process.)
+        When the kernel has been stripped, either automatically or by
+        using the commands above, you may install it as usual by typing
+        <command>make install</command>.</para>
+
+      <para>Note that older releases of FreeBSD (up to but not including
+        3.1) used a.out kernels by default, which must have their symbol
+        tables permanently resident in physical memory.  With the larger
+        symbol table in an unstripped debug kernel, this is wasteful.
+        Recent FreeBSD releases use ELF kernels where this is no longer a
+        problem.</para>
+    </tip>

right?  I'll commit this tonight if that's right, and I don't get
sidetracked...

--=20
Ben Smithurst                 / ben@FreeBSD.org / PGP: 0x99392F7D
FreeBSD Documentation Project /

--2qwbT0JTInWqknst
Content-Type: application/pgp-signature
Content-Disposition: inline

-----BEGIN PGP SIGNATURE-----
Version: PGPfreeware 5.0i for non-commercial use
MessageID: OH/nCTu38uw/PLAGerzifSZB4cuW1O8N

iQCVAwUBOW8UOSsPVtiZOS99AQGhhAP9HaFiF1zWqfUm5XlXYTCSCD1FKNYf2cLY
bYg4fGDBTx7fRaUuxp4cLPkjNwx5K+FrnJjie1MvJhrZoaxji4RJbSbMfifasLwW
9BYkfZEYKBb921qgnuo8XKrCGi8pvUqVC7X0oIyU+IGccZh2oKMIBm3NlawEaFiN
A0emZYSc9Tw=
=9BsZ
-----END PGP SIGNATURE-----

--2qwbT0JTInWqknst--


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message