From dpk@nod.malkavian.com  Mon Feb 26 14:07:21 2001
Return-Path: <dpk@nod.malkavian.com>
Received: from nod.malkavian.com (nod.malkavian.com [206.86.11.91])
	by hub.freebsd.org (Postfix) with ESMTP id E94DB37B401
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 26 Feb 2001 14:07:20 -0800 (PST)
	(envelope-from dpk@nod.malkavian.com)
Received: (from dpk@localhost)
	by nod.malkavian.com (8.11.0/8.9.3) id f1QM9Po19706;
	Mon, 26 Feb 2001 14:09:25 -0800 (PST)
	(envelope-from dpk)
Message-Id: <200102262209.f1QM9Po19706@nod.malkavian.com>
Date: Mon, 26 Feb 2001 14:09:25 -0800 (PST)
From: David Kirchner <dpk@malkavian.com>
Reply-To: dpk@malkavian.com
To: FreeBSD-gnats-submit@freebsd.org
Subject: Chapter 9 pages could use 'location of function' lines
X-Send-Pr-Version: 3.2

>Number:         25392
>Category:       docs
>Synopsis:       Chapter 9 pages could use 'location of function' lines
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Mon Feb 26 14:10:01 PST 2001
>Closed-Date:    Wed Jan 9 05:27:08 PST 2002
>Last-Modified:  Wed Jan 09 05:27:36 PST 2002
>Originator:     David Kirchner
>Release:        FreeBSD 4.1.1-STABLE i386 (any, though)
>Organization:
>Environment:
>Description:
	I've been having trouble trying to find functions in FreeBSD's
	kernel. The current "hard to find" function is VOP_READ. I can't
	find it defined anywhere under /usr/src/sys.

	It'd be great if the man pages for kernel functions (chapter 9) had
	something like:

	DEFINITION
		Found in /sys/kern/vnode_pager.c

	for example. It doesn't need a line number, that'd be too much
	to keep track of. Just something so we can find where these
	functions live, though.

	The same goes for the other library functions, but that'd be a lot
	more work.
>How-To-Repeat:
>Fix:
>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->suspended 
State-Changed-By: murray 
State-Changed-When: Mon Sep 3 18:07:26 PDT 2001 
State-Changed-Why:  
It is highly unlikely that this will be done.  At least not until we 
move to XML based man pages and have super tools in place to do this 
sort of thing automatically.  This is completely unfeasible to do 
manually. 

I think this PR should be closed. 

Thanks for the submission, but unless you've got a swell idea about 
how to accomplish this, I don't think it will get done. 



http://www.FreeBSD.org/cgi/query-pr.cgi?pr=25392 
State-Changed-From-To: suspended->closed 
State-Changed-By: nik 
State-Changed-When: Wed Jan 9 05:27:08 PST 2002 
State-Changed-Why:  
Suspended four months ago, no feedback from submitter since. 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=25392 
>Unformatted:
