Bug 25000

Summary: matcd(4) SYNOPSIS is wrong
Product: Documentation Reporter: rdm <rdm>
Component: Books & ArticlesAssignee: Murray Stokely <murray>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description rdm 2001-02-11 10:00:00 UTC
	/dev/[r]matcdl[0-15][a|c]
        ---
	/dev/[r]matcd[0-15]l[a|c]

Fix: 

Modify the man page, as noted above.
How-To-Repeat: 
	ls /dev/matcd*
        man 4 matcd
Comment 1 nik freebsd_committer freebsd_triage 2001-02-11 18:29:16 UTC
Rich,

I'm afraid you'll need to be a bit less cryptic.

On Sun, Feb 11, 2001 at 01:52:51AM -0800, Rich Morin wrote:
> >Number:         25000
> >Category:       docs
> >Synopsis:       matcd(4) SYNOPSIS is wrong

> >Description:
> 
> 	/dev/[r]matcdl[0-15][a|c]
>         ---
> 	/dev/[r]matcd[0-15]l[a|c]
> 
> >How-To-Repeat:
> 
> 	ls /dev/matcd*
>         man 4 matcd
> 
> >Fix:
> 
> 	Modify the man page, as noted above.

What's wrong with the man page?

N
-- 
Internet connection, $19.95 a month.  Computer, $799.95.  Modem, $149.95.
Telephone line, $24.95 a month.  Software, free.  USENET transmission,
hundreds if not thousands of dollars.  Thinking before posting, priceless.
Somethings in life you can't buy.  For everything else, there's MasterCard.
  -- Graham Reed, in the Scary Devil Monastery
Comment 2 rdm 2001-02-11 19:57:38 UTC
At 6:29 PM +0000 2/11/01, Nik Clayton wrote:
>Rich,
>
>I'm afraid you'll need to be a bit less cryptic.
>
>On Sun, Feb 11, 2001 at 01:52:51AM -0800, Rich Morin wrote:
>>  >Number:         25000
>>  >Category:       docs
>>  >Synopsis:       matcd(4) SYNOPSIS is wrong
>
>>  >Description:
>>
>>  	/dev/[r]matcdl[0-15][a|c]
>>          ---
>>  	/dev/[r]matcd[0-15]l[a|c]
>>
>>  >How-To-Repeat:
>>
>>  	ls /dev/matcd*
>>          man 4 matcd
>>
>>  >Fix:
>>
>>  	Modify the man page, as noted above.
>
>What's wrong with the man page?

What's wrong is that (in contradiction to the SYNOPSIS), there are no
devices named /dev/[r]matcdl[0-15][a|c], but there are devices named
/dev/[r]matcd[0-15]l[a|c]:

  %ls /dev/matcd*
  /dev/matcd0a    /dev/matcd0c    /dev/matcd0la   /dev/matcd0lc

Also, other text in the man page agrees with ls.  So, the SYNOPSIS
appears to be wrong.  Sorry if the initial PR was too cryptic; I
may have gotten infected by the style of the material I'm reading.

-r
-- 
--
http://www.cfcl.com/rdm
email: rdm@cfcl.com
phone: +1 650-873-7841
Comment 3 Murray Stokely freebsd_committer freebsd_triage 2001-09-03 11:07:36 UTC
State Changed
From-To: open->analyzed

The man page has been updated in -CURRENT.  Thanks for noticing!  It 
will be merged to -STABLE after the release of 4.4. 



Comment 4 Murray Stokely freebsd_committer freebsd_triage 2001-09-03 11:07:36 UTC
Responsible Changed
From-To: freebsd-doc->murray

My MFC reminder.
Comment 5 Murray Stokely freebsd_committer freebsd_triage 2001-09-04 05:39:53 UTC
State Changed
From-To: analyzed->closed

This change will be in FreeBSD 4.4, thanks!