From owner-freebsd-doc  Tue Mar  5 20: 0: 1 2002
Delivered-To: freebsd-doc@freebsd.org
Received: from rutger.owt.com (rutger.owt.com [204.118.6.16])
	by hub.freebsd.org (Postfix) with ESMTP id 63A5937B6E1
	for <freebsd-doc@FreeBSD.ORG>; Tue,  5 Mar 2002 19:58:32 -0800 (PST)
Received: from owt.com (owt-207-41-94-232.owt.com [207.41.94.232])
	by rutger.owt.com (8.9.3/8.9.3) with ESMTP id TAA02019;
	Tue, 5 Mar 2002 19:58:20 -0800
Message-ID: <3C8593DB.6090803@owt.com>
Date: Tue, 05 Mar 2002 19:58:19 -0800
From: Kent Stewart <kstewart@owt.com>
User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.0; en-US; rv:0.9.4) Gecko/20011128 Netscape6/6.2.1
X-Accept-Language: en-us, es-mx
MIME-Version: 1.0
To: Tom Rhodes <darklogik@pittgoth.com>
Cc: freebsd-doc@FreeBSD.ORG
Subject: Re: docs/34921: Developer's Handbook fixes continued: Kernel Debugging chapter
References: <3C8572FC.9090601@pittgoth.com>
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-doc.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-doc>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-doc>
X-Loop: FreeBSD.org



Tom Rhodes wrote:

> Kent Stewart wrote:
> 
>>
>>
>> murray@FreeBSD.ORG <mailto:murray@FreeBSD.ORG> wrote:
>>
>>> Synopsis: Developer's Handbook fixes continued: Kernel Debugging chapter
>>>
>>> State-Changed-From-To: open->closed
>>> State-Changed-By: murray
>>> State-Changed-When: Tue Mar 5 07:45:44 PST 2002
>>> State-Changed-Why: Committed in r1.40.  I noticed one more unecessary 
>>> word, but otherwise
>>> the patch was applied as submitted.  Thanks for the submission!
>>>
>>>
>>> http://www.FreeBSD.org/cgi/query-pr.cgi?pr=34921
>>>
>>
>>
>> When I try to update the docs, the make process doesn't understand 
>> <port> in the line
>>
>> the <port>devel/ddd</port> port in order to use the
>>
>> The error message is
>>
>> /usr/local/bin/jade:/usr/doc/en_US.ISO8859-1/books/developers-handbook/kerneldebug/chapter.sgml:247:15:E: 
>> element "PORT" undefined
>>
>> Kent
>>
> The use of <port> has become obsolete.  Recently a change was made where 
> you must now specify the use of a port/package with filename.  Hence, 
> your new code should look similar to this:
> 
> <filename role="package">net/cvsup</filename>
> 
> What is an unfortunate fact is, the current patches in gnats use <port> 
> instead of <filename>, and this
> will most likely require the submitter to resubmit the patch, or the 
> commiter to change it accordingly.
> 
> I hope this helps
> 

It helped. What I did was the following

--- chapter.sgml.orig   Tue Mar  5 19:48:18 2002
+++ chapter.sgml        Tue Mar  5 19:48:24 2002
@@ -244,7 +244,7 @@

      <para>Examining a kernel crash dump with a graphical debugger like
        <command>ddd</command> is also possible (you will need to install
-      the <port>devel/ddd</port> port in order to use the
+      the <filename role="package">devel/ddd</filename> port in order 
to use the
        <command>ddd</command> debugger).  Add the <option>-k</option>
        option to the <command>ddd</command> command line you would use
        normally.  For example;</para>

You have to unwrap the lines but the change links to the Port 
description for devel/ddd

Kent
-- 
Kent Stewart
Richland, WA

mailto:kbstew99@hotmail.com
http://users.owt.com/kstewart/index.html


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