From nobody@FreeBSD.org  Fri Mar 21 14:23:16 2008
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 6A4911065674
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 21 Mar 2008 14:23:16 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21])
	by mx1.freebsd.org (Postfix) with ESMTP id 5FF278FC1A
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 21 Mar 2008 14:23:16 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.14.2/8.14.2) with ESMTP id m2LENCab003449
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 21 Mar 2008 14:23:12 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.2/8.14.1/Submit) id m2LENCtU003448;
	Fri, 21 Mar 2008 14:23:12 GMT
	(envelope-from nobody)
Message-Id: <200803211423.m2LENCtU003448@www.freebsd.org>
Date: Fri, 21 Mar 2008 14:23:12 GMT
From: Federico <federicogalvezdurand@yahoo.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: reference to vinum() is wrong in newfs(8) man page.
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         121938
>Category:       docs
>Synopsis:       reference to vinum() is wrong in newfs(8) man page.
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    remko
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Mar 21 14:30:01 UTC 2008
>Closed-Date:    Mon Mar 24 10:46:52 UTC 2008
>Last-Modified:  Mon Mar 24 14:20:01 UTC 2008
>Originator:     Federico
>Release:        7.0-RELEASE
>Organization:
UFRJ
>Environment:
FreeBSD trinity.local 7.0-RELEASE FreeBSD 7.0-RELEASE #0: Fri Feb 29 17:08:36 CET 2008     root@trinity.local:/usr/obj/usr/src/sys/TRINITY  i386

>Description:
newfs(8) man page refers to vinum(8).
It should be vinum(4).
>How-To-Repeat:
man 8 newfs
>Fix:


Patch attached with submission follows:

--- man8/newfs.8.orig	2008-03-21 15:19:38.000000000 +0100
+++ man8/newfs.8	2008-03-21 15:18:44.000000000 +0100
@@ -246,7 +246,7 @@
 .Xr fsck 8 ,
 .Xr mount 8 ,
 .Xr tunefs 8 ,
-.Xr vinum 8
+.Xr vinum 4
 .Rs
 .%A M. McKusick
 .%A W. Joy


>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->patched 
State-Changed-By: remko 
State-Changed-When: Fri Mar 21 20:17:12 UTC 2008 
State-Changed-Why:  
set to patched, did so in current. 


Responsible-Changed-From-To: freebsd-doc->remko 
Responsible-Changed-By: remko 
Responsible-Changed-When: Fri Mar 21 20:17:12 UTC 2008 
Responsible-Changed-Why:  
reassign to me 

http://www.freebsd.org/cgi/query-pr.cgi?pr=121938 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/121938: commit references a PR
Date: Fri, 21 Mar 2008 20:16:30 +0000 (UTC)

 remko       2008-03-21 20:16:25 UTC
 
   FreeBSD src repository
 
   Modified files:
     sbin/newfs           newfs.8 
   Log:
   Replace reference from vinum.8 to gvinum.8, it was advised in the PR to
   replace this with vinum.4, but that's the kernel interface manual, which
   is not appropriate in my understanding.  I think that gvinum is a suitable
   replacement for this.
   
   PR:             docs/121938
   Submitted by:   "Federico" <federicogalvezdurand at yahoo dot com>
   MFC after:      3 days
   
   Revision  Changes    Path
   1.73      +2 -2      src/sbin/newfs/newfs.8
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: patched->closed 
State-Changed-By: remko 
State-Changed-When: Mon Mar 24 10:46:51 UTC 2008 
State-Changed-Why:  
Committed. Thanks! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=121938 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/121938: commit references a PR
Date: Mon, 24 Mar 2008 10:45:25 +0000 (UTC)

 remko       2008-03-24 10:45:17 UTC
 
   FreeBSD src repository
 
   Modified files:        (Branch: RELENG_6)
     sbin/newfs           newfs.8 
   Log:
   MFC rev 1.73 newfs.8
   
     Replace reference from vinum.8 to gvinum.8, it was advised in the PR to
     replace this with vinum.4, but that's the kernel interface manual, which
     is not appropriate in my understanding.  I think that gvinum is a suitable
     replacement for this.
   
     PR:             docs/121938
     Submitted by:   "Federico" <federicogalvezdurand at yahoo dot com>
     MFC after:      3 days
   
   Revision  Changes    Path
   1.69.2.1  +2 -2      src/sbin/newfs/newfs.8
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/121938: commit references a PR
Date: Mon, 24 Mar 2008 10:46:04 +0000 (UTC)

 remko       2008-03-24 10:46:00 UTC
 
   FreeBSD src repository
 
   Modified files:        (Branch: RELENG_7)
     sbin/newfs           newfs.8 
   Log:
   MFC rev 1.73 newfs.8
   
     Replace reference from vinum.8 to gvinum.8, it was advised in the PR to
     replace this with vinum.4, but that's the kernel interface manual, which
     is not appropriate in my understanding.  I think that gvinum is a suitable
     replacement for this.
   
     PR:             docs/121938
     Submitted by:   "Federico" <federicogalvezdurand at yahoo dot com>
     MFC after:      3 days
   
   Revision  Changes    Path
   1.70.2.1  +2 -2      src/sbin/newfs/newfs.8
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 

From: Federico Galvez-Durand <federicogalvezdurand@yahoo.com>
To: remko@FreeBSD.org, bug-followup@freebsd.org
Cc:  
Subject: Re: docs/121938: reference to vinum() is wrong in newfs(8) man page.
Date: Mon, 24 Mar 2008 05:12:27 -0700 (PDT)

 --- remko@FreeBSD.org wrote:
 
 > Synopsis: reference to vinum() is wrong in newfs(8)
 > man page.
 > 
 > State-Changed-From-To: patched->closed
 > State-Changed-By: remko
 > State-Changed-When: Mon Mar 24 10:46:51 UTC 2008
 > State-Changed-Why: 
 > Committed. Thanks!
 > 
 > http://www.freebsd.org/cgi/query-pr.cgi?pr=121938
 > 
 
 In newfs(8) the main (and maybe only) reason to call a
 reference on vinum(4) was the deprecated usage of
 "newfs -v " (Releases < 5.x) to create a UFS file
 system on a vinum volume.
 
 That reference is still there in vinum(4) with
 insufficient wording, it should say it is valid only
 for Releases < 5.x. 
 
 Section 20.7.1 is also confusing on this matter
 invoking the same usage of newfs to show the wrong and
 right way of creating a file system on a vinum(4)
 volume.
 
 Using gvinum(8) does not help to understand how to use
 newfs(8) to create a new UFS file system on a vinum(4)
 volume. Therefore, I do not see the point on calling a
 reference to gvinum(8) in newfs(8). At least not with
 this version of gvinum(8).
 
 If the reference to vinum(4) in newfs(8) is not
 desirable then it should be glabel(8), which advises
 the right way of using newfs(8) to create a file
 system on a vinum volume.
 
 If you agree on: 
 a) removing vinum(x) from newfs(8) references;
 b) adding glabel(8) to newfs(8) references; 
 then I can submit a patch for newfs(8), vinum(4) and
 Section 20.7.1 with the right text, for your
 approval/rejection.
 
 Please, advise.
 
 
 
 
       ____________________________________________________________________________________
 Looking for last minute shopping deals?  
 Find them fast with Yahoo! Search.  http://tools.search.yahoo.com/newsearch/category.php?category=shopping

From: Federico Galvez-Durand <federicogalvezdurand@yahoo.com>
To: remko@FreeBSD.org
Cc: bug-followup freeBSD <bug-followup@freebsd.org>
Subject: Re: docs/121938: reference to vinum() is wrong in newfs(8) man page.
Date: Mon, 24 Mar 2008 07:16:20 -0700 (PDT)

 --- remko@FreeBSD.org wrote:
 
 > Synopsis: reference to vinum() is wrong in newfs(8)
 > man page.
 > 
 > State-Changed-From-To: patched->closed
 > State-Changed-By: remko
 > State-Changed-When: Mon Mar 24 10:46:51 UTC 2008
 > State-Changed-Why: 
 > Committed. Thanks!
 > 
 > http://www.freebsd.org/cgi/query-pr.cgi?pr=121938
 > 
 
 Sorry, replying to myself.
 I take it back, glabel(8) has nothing to do with
 labeling a vinum(4) volume... I need more sleep.
 
 *The Handbook Section 20.7.1 needs clean up. It is not
 clear which usages of newfs(8) there is the correct.
 *The suggested gvinum(8) replacement for vinum(4) in
 newfs(8) does not really contribute to newfs(8).
 *The vinum(4) needs a modification in sub-section
 MAKING FILE SYSTEMS.
 
 .
 
 
 
       ____________________________________________________________________________________
 Never miss a thing.  Make Yahoo your home page. 
 http://www.yahoo.com/r/hs
>Unformatted:
