From rfg@monkeys.com Wed Oct 27 17:48:56 1999
Return-Path: <rfg@monkeys.com>
Received: from monkeys.com (i180.value.net [206.14.136.180])
	by hub.freebsd.org (Postfix) with ESMTP id AADD315040
	for <FreeBSD-gnats-submit@freebsd.org>; Wed, 27 Oct 1999 17:48:44 -0700 (PDT)
	(envelope-from rfg@monkeys.com)
Received: (from rfg@localhost)
	by monkeys.com (8.9.3/8.9.3) id RAA64615;
	Wed, 27 Oct 1999 17:48:42 -0700 (PDT)
Message-Id: <199910280048.RAA64615@monkeys.com>
Date: Wed, 27 Oct 1999 17:48:42 -0700 (PDT)
From: "Ronald F. Guilmette" <rfg@monkeys.com>
Reply-To: rfg@monkeys.com (Ronald F. Guilmette)
To: FreeBSD-gnats-submit@freebsd.org
Subject: camcontrol(8) sez to see cam(9) and xpt(9) but there ain't no such
X-Send-Pr-Version: 3.2

>Number:         14567
>Category:       docs
>Synopsis:       camcontrol(8) sez to see cam(9) and xpt(9) but there ain't no such
>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:   Wed Oct 27 17:50:01 PDT 1999
>Closed-Date:    Thu Oct 28 13:20:23 EDT 1999
>Last-Modified:  Thu Oct 28 13:21:13 EDT 1999
>Originator:     Ronald F. Guilmette
>Release:        FreeBSD 3.3-RELEASE i386
>Organization:
E-Scrub Technologies, Inc.
>Environment:

>Description:

	The camcontrol(8) man page sez:

	SEE ALSO
		cam(3),  cam_cdbparse(3),  pass(4),  cam(9),  xpt(9)
                                                     ^^^^^^   ^^^^^^

	Unfortunately, `man 9 cam' produces only:

		No entry for cam in section 9 of the manual

	Likewise for `man 9 xpt'.

>How-To-Repeat:

	man 9 cam
	man 9 xpt

>Fix:

	? Create a cam(9) man page ?

>Release-Note:
>Audit-Trail:

From: Chris Costello <chris@calldei.com>
To: "Ronald F. Guilmette" <rfg@monkeys.com>
Cc: FreeBSD-gnats-submit@FreeBSD.ORG
Subject: Re: docs/14567: camcontrol(8) sez to see cam(9) and xpt(9) but there
 ain't no such
Date: Wed, 27 Oct 1999 19:55:23 -0500

 On Wed, Oct 27, 1999, Ronald F. Guilmette wrote:
 > >Fix:
 > 
 > 	? Create a cam(9) man page ?
 
    Yes please.  You can send the patches as a reply to this PR.
 I've been meaning to figure out what to document, but if you're
 willing to do it, I will accept, review (and have Ken review)
 and commit the pages.
 
 -- 
 |Chris Costello <chris@calldei.com>
 |If you have a procedure with 10 parameters, you probably missed some.
 `---------------------------------------------------------------------
 

From: "Ronald F. Guilmette" <rfg@monkeys.com>
To: chris@calldei.com
Cc: "Ronald F. Guilmette" <rfg@monkeys.com>,
	FreeBSD-gnats-submit@FreeBSD.ORG
Subject: Re: docs/14567: camcontrol(8) sez to see cam(9) and xpt(9) but there ain't no such 
Date: Wed, 27 Oct 1999 18:08:30 -0700

 In message <19991027195523.F70024@holly.calldei.com>, you wrote:
 
 >On Wed, Oct 27, 1999, Ronald F. Guilmette wrote:
 >> >Fix:
 >> 
 >> 	? Create a cam(9) man page ?
 >
 >   Yes please.  You can send the patches as a reply to this PR.
 >I've been meaning to figure out what to document, but if you're
 >willing to do it, I will accept, review (and have Ken review)
 >and commit the pages.
 
 Umm....
 
 I'd love to help out.  Really.  But given that I don't have the foggiest
 idea what `cam' even is, I don't think that I'm the proper person to be
 doing this particular task.
 
 

From: Matthew Hunt <mph@astro.caltech.edu>
To: Chris Costello <chris@calldei.com>
Cc: freebsd-gnats-submit@freebsd.org, ken@freebsd.org
Subject: Re: docs/14567: camcontrol(8) sez to see cam(9) and xpt(9) but there ain't no such
Date: Thu, 28 Oct 1999 09:39:20 -0700

 On Wed, Oct 27, 1999 at 06:00:02PM -0700, Chris Costello wrote:
 
 >  > 	? Create a cam(9) man page ?
 >  
 >     Yes please.  You can send the patches as a reply to this PR.
 >  I've been meaning to figure out what to document, but if you're
 >  willing to do it, I will accept, review (and have Ken review)
 >  and commit the pages.
 
 cam(4) and xpt(4) exist.  My assumption is that camcontrol(8)
 should refer to these, and the (9) was a mistake?
 
 -- 
 Matthew Hunt <mph@astro.caltech.edu> * UNIX is a lever for the
 http://www.pobox.com/~mph/           * intellect. -J.R. Mashey
 

From: "Kenneth D. Merry" <ken@kdm.org>
To: mph@astro.caltech.edu (Matthew Hunt)
Cc: chris@calldei.com (Chris Costello),
	freebsd-gnats-submit@freebsd.org
Subject: Re: docs/14567: camcontrol(8) sez to see cam(9) and xpt(9) but there ain't no such
Date: Thu, 28 Oct 1999 10:59:22 -0600 (MDT)

 Matthew Hunt wrote...
 > On Wed, Oct 27, 1999 at 06:00:02PM -0700, Chris Costello wrote:
 > 
 > >  > 	? Create a cam(9) man page ?
 > >  
 > >     Yes please.  You can send the patches as a reply to this PR.
 > >  I've been meaning to figure out what to document, but if you're
 > >  willing to do it, I will accept, review (and have Ken review)
 > >  and commit the pages.
 > 
 > cam(4) and xpt(4) exist.  My assumption is that camcontrol(8)
 > should refer to these, and the (9) was a mistake?
 
 Yes, camcontrol(8) should refer to cam(4) and xpt(4).
 
 As for the xpt(9) and cam(9) references, look in the BUGS section of the
 camcontrol(8) man page:
 
 BUGS
      Most of the man page cross references don't exist yet.  This will be
      fixed soon.
 
 Of course, it's been over a year, and I haven't had time to write cam(9) or
 xpt(9).
 
 If the missing cross-references are causing problems, go ahead and take
 them out, but make sure you take out the paragraph from the BUGS section
 as well.
 
 Ken
 -- 
 Kenneth Merry
 ken@kdm.org
 
State-Changed-From-To: open->closed 
State-Changed-By: mph 
State-Changed-When: Thu Oct 28 13:20:23 EDT 1999 
State-Changed-Why:  
I have added cam(4) and xpt(4) to SEE ALSO, deleted cam(9) and xpt(9) which 
do not exist, and deleted the BUGS statement which says they'll be 
added soon. 
>Unformatted:
