Bug 122053

Summary: [patch] update on vinum(4) reference to newfs(8)
Product: Documentation Reporter: Federico GDB <federicogalvezdurand>
Component: Books & ArticlesAssignee: Tom Rhodes <trhodes>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
file.diff
none
patch_200804211838 none

Description Federico GDB 2008-03-24 16:10:02 UTC
MAKING FILE SYSTEM sub-section on vinum(4) need update on how to use newfs(8).

Fix: Patch attached with submission follows:
Comment 1 Remko Lodder 2008-03-24 16:34:07 UTC
> MAKING FILE SYSTEM sub-section on vinum(4) need update on how to use
> newfs(8).
>>How-To-Repeat:
>
>>Fix:
>
>
> >
> --- man.orig/man4/vinum.4	2006-06-11 21:41:07.000000000 +0200
> +++ man/man4/vinum.4	2008-03-24 17:01:39.000000000 +0100
> @@ -428,18 +428,20 @@
>  For a physical disk partition, the
>  last letter of the device name specifies the partition identifier (a to
> h).
>  .Nm
> -volumes need not conform to this convention, but if they do not,
> -.Xr newfs 8
> -will complain that it cannot determine the partition.
> -To solve this problem,
> -use the
> -.Fl v
> -flag to
> -.Xr newfs 8 .
> +volumes does not need to conform with this convention.
>  For example, if you have a volume
>  .Pa concat ,
>  use the following command to create a UFS file system on it:
>  .Pp
> +.Dl "newfs /dev/gvinum/concat"
> +.Pp
> +.Ss Note:
> +On FreeBSD versions prior to 5.0
> +.Xr newfs 8
> +requires an additional
> +.Fl v
> +flag and the old device naming scheme:
> +.Pp

Only this should be mentioned in <5.0 which is no longer supported. It has
no reason whatsoever in later revision. We recently cleared out a lot of
these items that were for older releases that we are not supporting
anymore. The note shouldn't be there.

>  .Dl "newfs -v /dev/vinum/concat"
>  .Sh OBJECT NAMING
>  .Nm
>


-- 
/"\   Best regards,                      | remko@FreeBSD.org
\ /   Remko Lodder                       | remko@EFnet
 X    http://www.evilcoder.org/          |
/ \   ASCII Ribbon Campaign              | Against HTML Mail and News
Comment 2 Federico GDB 2008-04-21 17:38:06 UTC
--- Remko Lodder <remko@elvandar.org> wrote:

> 
> 
> > MAKING FILE SYSTEM sub-section on vinum(4) need update on how to use
> > newfs(8).
> >>How-To-Repeat:
> >
> >>Fix:
> >
> >
> > > >
> > --- man.orig/man4/vinum.4	2006-06-11 21:41:07.000000000 +0200
> > +++ man/man4/vinum.4	2008-03-24 17:01:39.000000000 +0100
> > @@ -428,18 +428,20 @@
> >  For a physical disk partition, the
> >  last letter of the device name specifies the partition identifier (a to
> > h).
> >  .Nm
> > -volumes need not conform to this convention, but if they do not,
> > -.Xr newfs 8
> > -will complain that it cannot determine the partition.
> > -To solve this problem,
> > -use the
> > -.Fl v
> > -flag to
> > -.Xr newfs 8 .
> > +volumes does not need to conform with this convention.
> >  For example, if you have a volume
> >  .Pa concat ,
> >  use the following command to create a UFS file system on it:
> >  .Pp
> > +.Dl "newfs /dev/gvinum/concat"
> > +.Pp
> > +.Ss Note:
> > +On FreeBSD versions prior to 5.0
> > +.Xr newfs 8
> > +requires an additional
> > +.Fl v
> > +flag and the old device naming scheme:
> > +.Pp
> 
> Only this should be mentioned in <5.0 which is no longer supported. It has
> no reason whatsoever in later revision. We recently cleared out a lot of
> these items that were for older releases that we are not supporting
> anymore. The note shouldn't be there.
> 
> >  .Dl "newfs -v /dev/vinum/concat"
> >  .Sh OBJECT NAMING
> >  .Nm
> >
> 
> 

This patch updates vinum(4) in several ways and adds examples and vinum(4) reference to gvinum(8).
Fico.




      ____________________________________________________________________________________
Be a better friend, newshound, and 
know-it-all with Yahoo! Mobile.  Try it now.  http://mobile.yahoo.com/;_ylt=Ahu06i62sR8HDtDypao8Wcj9tAcJ
Comment 3 Tom Rhodes freebsd_committer freebsd_triage 2009-01-23 00:13:45 UTC
State Changed
From-To: open->closed

Close this PR. 

A reference to gvinum was added ages ago, and since vinum 
is no longer available, there seems to be little reason 
describing its continued use.  After some discussion with 
Remko (and others), it seems best to just leave the 
current manual page untouched until it is removed.  Thanks! 


Comment 4 Tom Rhodes freebsd_committer freebsd_triage 2009-01-23 00:13:45 UTC
Responsible Changed
From-To: freebsd-doc->trhodes

Over to me.