Bug 84409

Summary: handbook: vinum-object-naming.html -v/-U typo
Product: Documentation Reporter: Gary W. Swearingen <garys>
Component: Books & ArticlesAssignee: Remko Lodder <remko>
Status: Closed FIXED    
Severity: Affects Only Me CC: fury
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Gary W. Swearingen 2005-07-31 22:00:25 UTC 
doc@ mail From: Richard Stride <fury@nexxus.net>

At the very end of this page:

http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/vinum-object-naming.html

Section 17.7.1 says:

# newfs -v /dev/vinum/concat

which refers to the newfs command manpage linked on the same page:

http://www.freebsd.org/cgi/man.cgi?query=newfs&sektion=8

which shows there is no -v option.

This is not helpful and should be corrected to what the current vinum manpage suggests as

# newfs -U /dev/vinum/concat

Thanks,
Richard Stride
Comment 1 Ceri Davies 2005-08-01 23:25:17 UTC 
On 31 Jul 2005, at 21:56, Gary W. Swearingen wrote:

> doc@ mail From: Richard Stride <fury@nexxus.net>
>
> At the very end of this page:
>
> http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/vinum- 
> object-naming.html
>
> Section 17.7.1 says:
>
> # newfs -v /dev/vinum/concat
>
> which refers to the newfs command manpage linked on the same page:
>
> http://www.freebsd.org/cgi/man.cgi?query=newfs&sektion=8
>
> which shows there is no -v option.
>
> This is not helpful and should be corrected to what the current  
> vinum manpage suggests as
>
> # newfs -U /dev/vinum/concat

-U is not correct here.

There used to be (and still is) a -v option in RELENG_4, which is  
still required when newfs'ing a vinum volume.

The -v text needs to be conditional on whether the user is in the  
post 5.x world or not.

Ceri
-- 
Only two things are infinite, the universe and human stupidity, and I'm
not sure about the former.                        -- Einstein (attrib.)
Comment 2 Remko Lodder freebsd_committer freebsd_triage 2005-12-30 23:52:36 UTC 
Responsible Changed
From-To: freebsd-doc->remko

Daniel Gerzo and I discussed this tonight, I will work on solving 
this item together with Daniel. Grab the PR s reference.
Comment 3 Remko Lodder freebsd_committer freebsd_triage 2006-03-19 15:48:09 UTC 
State Changed
From-To: open->closed

After the latest updates to the vinum chapter, the example got bogus so 
it really needed updating now.  I updated the text for newer FreeBSD 
versions and listed a compatible command for FreeBSD < 5.0. 

This makes sure the examples are correct again. 

Close the PR since the above is now solved.