From nobody@FreeBSD.org  Mon Sep  3 11:13:56 2007
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 215E716A420
	for <freebsd-gnats-submit@FreeBSD.org>; Mon,  3 Sep 2007 11:13:56 +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 F1C0E13C48D
	for <freebsd-gnats-submit@FreeBSD.org>; Mon,  3 Sep 2007 11:13:55 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.14.1/8.14.1) with ESMTP id l83BDtsM036231
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 3 Sep 2007 11:13:55 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.1/8.14.1/Submit) id l83BDtcQ036230;
	Mon, 3 Sep 2007 11:13:55 GMT
	(envelope-from nobody)
Message-Id: <200709031113.l83BDtcQ036230@www.freebsd.org>
Date: Mon, 3 Sep 2007 11:13:55 GMT
From: Ian Smith <smithi@nimnet.asn.au>
To: freebsd-gnats-submit@FreeBSD.org
Subject: bsdlabel(8) manpage doesn't mention 'auto' type for -w 
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         116047
>Category:       docs
>Synopsis:       [patch] bsdlabel(8) manpage doesn't mention 'auto' type for -w
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    remko
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Sep 03 11:20:13 GMT 2007
>Closed-Date:    Sun Feb 10 12:31:22 UTC 2008
>Last-Modified:  Thu Feb 14 21:50:03 UTC 2008
>Originator:     Ian Smith
>Release:        5.5-STABLE and 6.1-RELEASE
>Organization:
Nimbin Network Association
>Environment:
FreeBSD paqi.nimnet.asn.au 5.5-STABLE FreeBSD 5.5-STABLE #0: Sat Mar  3 03:14:13 EST 2007     root@paqi.nimnet.asn.au:/usr/obj/usr/src/sys/PAQI5S_3  i386

>Description:
This applies equally to the 7-CURRENT manpage (footer: FreeBSD 6.2) at
http://www.freebsd.org/cgi/man.cgi?query=bsdlabel&apropos=0&sektion=0&manpath=FreeBSD+7-current&format=html

bsdlabel(8) fails to mention that type 'auto' may be used instead of not
specifying any type.  mdconfig(8), at least, uses 'bsdlabel -w md0 auto'
in an example, which is why I found it missing.

>  Writing a Standard Label
>     To write a standard label, use the form
>
>     bsdlabel -w [-An] [-m machine] disk [type]
>
>     If the drive type is specified, the entry of that name in the disktab(5)
>     file is used; otherwise a default layout is used.

'auto' is the value adopted if no type is specified anyway.  bsdlabel.c:

        case WRITE:
                if (argc == 2)
                        name = argv[1];
                else if (argc == 1)
                        name = "auto";
                else
                        usage();
                readlabel(0);
                makelabel(name, &lab);

makelabel() then uses type 'auto' to call getvirginlabel() rather than
to getdiskbyname(type) from /etc/disktab

Bit trivial for a first docs PR, but Kris said I should :)

>How-To-Repeat:
man mdconfig   # second last example
man bsdlabel   # search for 'auto'

>Fix:
A proper patch would only be against my 5.5-STABLE (Mar07) but suggested:

      If the drive type is specified, the entry of that name in the disktab(5)
-     file is used; otherwise a default layout is used.

      If the drive type is specified, the entry of that name in the disktab(5)
+     file is used; otherwise - or if specified as 'auto' - a default layout
+     is used.


>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->patched 
State-Changed-By: remko 
State-Changed-When: Sat Dec 8 19:58:07 UTC 2007 
State-Changed-Why:  
Patch applied on -CURRENT. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=116047 
Responsible-Changed-From-To: freebsd-doc->remko 
Responsible-Changed-By: remko 
Responsible-Changed-When: Sat Dec 8 19:59:13 UTC 2007 
Responsible-Changed-Why:  
Also take over this ticket 

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

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/116047: commit references a PR
Date: Sat,  8 Dec 2007 19:57:27 +0000 (UTC)

 remko       2007-12-08 19:57:22 UTC
 
   FreeBSD src repository
 
   Modified files:
     sbin/bsdlabel        bsdlabel.8 
   Log:
   Attempt to describe the ''auto'' type a bit better in the default
   section (if nothing had been specified, or if the auto type had
   been specified, a default layout is used).
   
   PR:             docs/116047
   Submitted by:   Ian Smith <smithi at nimnet dot asn dot au>
                   Minor modifications by me.
   
   Revision  Changes    Path
   1.69      +3 -2      src/sbin/bsdlabel/bsdlabel.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: Sun Feb 10 12:31:21 UTC 2008 
State-Changed-Why:  
MFC'ed to all relevant branches, thanks for the submission! 

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

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/116047: commit references a PR
Date: Sun, 10 Feb 2008 12:30:36 +0000 (UTC)

 remko       2008-02-10 12:30:30 UTC
 
   FreeBSD src repository
 
   Modified files:        (Branch: RELENG_6)
     sbin/bsdlabel        bsdlabel.8 
   Log:
   MFC rev 1.69 bsdlabel.8
   
     Attempt to describe the ''auto'' type a bit better in the default
     section (if nothing had been specified, or if the auto type had
     been specified, a default layout is used).
   
     PR: docs/116047
     Submitted by: Ian Smith <smithi at nimnet dot asn dot au>
     Minor modifications by me.
   
   Revision  Changes    Path
   1.60.2.4  +3 -2      src/sbin/bsdlabel/bsdlabel.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/116047: commit references a PR
Date: Sun, 10 Feb 2008 12:31:13 +0000 (UTC)

 remko       2008-02-10 12:31:06 UTC
 
   FreeBSD src repository
 
   Modified files:        (Branch: RELENG_7)
     sbin/bsdlabel        bsdlabel.8 
   Log:
   MFC rev 1.69 bsdlabel.8
   
     Attempt to describe the ''auto'' type a bit better in the default
     section (if nothing had been specified, or if the auto type had
     been specified, a default layout is used).
   
     PR: docs/116047
     Submitted by: Ian Smith <smithi at nimnet dot asn dot au>
     Minor modifications by me.
   
   Revision  Changes    Path
   1.68.2.1  +3 -2      src/sbin/bsdlabel/bsdlabel.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/116047: commit references a PR
Date: Thu, 14 Feb 2008 21:46:26 +0000 (UTC)

 remko       2008-02-14 21:46:19 UTC
 
   FreeBSD src repository
 
   Modified files:        (Branch: RELENG_7_0)
     sbin/bsdlabel        bsdlabel.8 
   Log:
   MFC rev 1.69 to 1.70 bsdlabel.8
   
     v1.70
     Remove redundant whitespace.
   
     Noticed by:   brueffer
   
     v1.69
     Attempt to describe the ''auto'' type a bit better in the default
     section (if nothing had been specified, or if the auto type had
     been specified, a default layout is used).
   
     PR:           docs/116047
     Submitted by: Ian Smith <smithi at nimnet dot asn dot au>
                   Minor modifications by me.
   
   Approved by:    re (bmah)
   
   Revision  Changes    Path
   1.68.4.1  +3 -2      src/sbin/bsdlabel/bsdlabel.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"
 
>Unformatted:
