From owner-freebsd-doc@FreeBSD.ORG  Sat May 17 09:07:25 2003
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP
	id 746E137B404; Sat, 17 May 2003 09:07:25 -0700 (PDT)
Received: from thalia.otenet.gr (mailsrv.otenet.gr [195.170.0.5])
	by mx1.FreeBSD.org (Postfix) with ESMTP
	id F33AE43FB1; Sat, 17 May 2003 09:07:23 -0700 (PDT)
	(envelope-from keramida@freebsd.org)
Received: from gothmog.gr (patr530-b229.otenet.gr [212.205.244.237])
	by thalia.otenet.gr (8.12.9/8.12.9) with ESMTP id h4HG7KoA020981;
	Sat, 17 May 2003 19:07:21 +0300 (EEST)
Received: from gothmog.gr (gothmog [127.0.0.1])
	by gothmog.gr (8.12.9/8.12.9) with ESMTP id h4HG7Ffn047631;
	Sat, 17 May 2003 19:07:21 +0300 (EEST)
	(envelope-from keramida@freebsd.org)
Received: (from giorgos@localhost)
	by gothmog.gr (8.12.9/8.12.9/Submit) id h4H54Hfa006907;
	Sat, 17 May 2003 08:04:17 +0300 (EEST)
	(envelope-from keramida@freebsd.org)
Date: Sat, 17 May 2003 08:04:17 +0300
From: Giorgos Keramidas <keramida@freebsd.org>
To: Hiten Pandya <hmp@freebsd.org>
Message-ID: <20030517050417.GA20807@gothmog.gr>
References: <200305161127.h4GBR0QJ013946@freefall.freebsd.org>
	<20030516114541.26131d4f.trhodes@FreeBSD.org>
	<20030516175320.GA91137@intruder.bmah.org>
	<20030516155637.668d03e0.trhodes@FreeBSD.org>
	<20030516201805.GA34240@perrin.int.nxad.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20030516201805.GA34240@perrin.int.nxad.com>
cc: Tom Rhodes <trhodes@freebsd.org>
cc: freebsd-doc@freebsd.org
Subject: Re: docs/39214: No my(4) man page
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sat, 17 May 2003 16:07:25 -0000

On 2003-05-16 13:18, Hiten Pandya <hmp@freebsd.org> wrote:
>On Fri, May 16, 2003 at 03:56:37PM -0400, Tom Rhodes wrote:
>> - Another thing you could do, to expand on the page a
>> little bit is add a .Sh FILES section and list the two files:
>>
>> .Pa /usr/src/sys/dev/my/if_my.c
>> and
>> .Pa /usr/src/sys/dev/my/if_myreg.h
>>
>> and add a small description of them.
>
> 	Ok, a FILES section sounds a like a good idea. 8-)

I'm not sure, but it's your work so don't let me stop you from doing
useful things.  The only manpages in section 4 that mention files
under /usr/src are vlan.4 and vinum.4.  Drivers aren't very likely to
move around in the tree but I don't feel very comfortable with paths
being hardwired in manpages unless it's absolutely unavoidable.

You should probably ask DES, Ruslan, Bruce Evans or another experienced
src-hacker before doing this.