From barner@in.tum.de  Mon Feb 16 06:57:17 2004
Return-Path: <barner@in.tum.de>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id B167F16A4CE
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 16 Feb 2004 06:57:17 -0800 (PST)
Received: from tuminfo2.informatik.tu-muenchen.de (tuminfo2.informatik.tu-muenchen.de [131.159.0.81])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 8035043D2D
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 16 Feb 2004 06:57:17 -0800 (PST)
	(envelope-from barner@in.tum.de)
Received: by zi025.glhnet.mhn.de (Postfix, from userid 1000)
	id A57649B57; Mon, 16 Feb 2004 15:57:15 +0100 (CET)
Message-Id: <20040216145715.A57649B57@zi025.glhnet.mhn.de>
Date: Mon, 16 Feb 2004 15:57:15 +0100 (CET)
From: Simon Barner <barner@in.tum.de>
Reply-To: Simon Barner <barner@in.tum.de>
To: FreeBSD-gnats-submit@freebsd.org
Cc: richardcoleman@mindspring.com
Subject: Reference development(7) in other parts of documentation
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         62914
>Category:       docs
>Synopsis:       Reference development(7) in other parts of documentation
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Feb 16 07:00:32 PST 2004
>Closed-Date:    Fri Mar 18 02:17:32 GMT 2005
>Last-Modified:  Fri Mar 18 02:17:32 GMT 2005
>Originator:     Simon Barner
>Release:        FreeBSD 4.9-PRERELEASE i386
>Organization:
>Environment:
System: FreeBSD zi025.glhnet.mhn.de 4.9-PRERELEASE FreeBSD 4.9-PRERELEASE #1: Thu Sep 4 20:49:53 CEST 2003 simon@zi025.glhnet.mhn.de:/usr/src/sys/compile/KISTE i386

>Description:

As stated by Richard Coleman in
http://lists.freebsd.org/pipermail/freebsd-hackers/2004-February/005714.html

the development(7) man page should be cross-referenced in other parts of
the FreeBSD documentation, e.g. in the Developer's Handbook.

I could even imagine a section in Chapter 2 "Programming Tools", which could
be something like "Setting up a FreeBSD development environment", where
the (eventually revised) contents of the man page could be rewritten
in DocBook. I could do the man page -> DocBook conversion, but without
any contributions with regards to contents.

If a new section in the Developer's Handbook in inappropriate, then the
man page should be at least be linked somewhere.

>How-To-Repeat:

N/A

>Fix:

N/A
>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: murray 
State-Changed-When: Fri Mar 18 02:16:57 GMT 2005 
State-Changed-Why:  
Thanks for the submission.  I added a link to development.7 in the 
Further Reading section.  It may take up to 24 hours for this change 
to appear on the website. 


http://www.freebsd.org/cgi/query-pr.cgi?pr=62914 
>Unformatted:
