From rfg@tristatelogic.com  Thu Mar 28 23:09:11 2013
Return-Path: <rfg@tristatelogic.com>
Received: from mx1.freebsd.org (mx1.FreeBSD.org [8.8.178.115])
	by hub.freebsd.org (Postfix) with ESMTP id 89658920
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 28 Mar 2013 23:09:11 +0000 (UTC)
	(envelope-from rfg@tristatelogic.com)
Received: from outgoing.tristatelogic.com (segfault.tristatelogic.com [69.62.255.118])
	by mx1.freebsd.org (Postfix) with ESMTP id 6DDCD9B4
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 28 Mar 2013 23:09:11 +0000 (UTC)
Received: by segfault.tristatelogic.com (Postfix, from userid 1237)
	id D4E853BB5F; Thu, 28 Mar 2013 16:09:02 -0700 (PDT)
Message-Id: <20130328230902.D4E853BB5F@segfault.tristatelogic.com>
Date: Thu, 28 Mar 2013 16:09:02 -0700 (PDT)
From: Ronald F.Guilmette <rfg@tristatelogic.com>
Reply-To: Ronald F.Guilmette <rfg@tristatelogic.com>
To: FreeBSD-gnats-submit@freebsd.org
Cc: rfg@tristatelogic.com
Subject: glabel(8) man page dangling verbal reference
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         177455
>Category:       docs
>Synopsis:       glabel(8) man page dangling verbal reference
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    joel
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Mar 28 23:10:00 UTC 2013
>Closed-Date:    Mon Apr 22 17:40:13 UTC 2013
>Last-Modified:  Mon Apr 22 17:50:00 UTC 2013
>Originator:     Ronald F. Guilmette
>Release:        FreeBSD 9.1-RELEASE amd64
>Organization:
entr0py
>Environment:

FreeBSD 9.1-RELEASE amd64

>Description:

The man page for glabel(8) sez:

	"This class also provides..."

Question:  What class?

(I won't be enrolled in art class until the Fall semester. :-)

>How-To-Repeat:

man 8 glabel

>Fix:

Edit man page.
>Release-Note:
>Audit-Trail:

From: Peter Pentchev <roam@ringlet.net>
To: "Ronald F.Guilmette" <rfg@tristatelogic.com>
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/177455: glabel(8) man page dangling verbal reference
Date: Fri, 29 Mar 2013 15:21:14 +0200

 --E39vaYmALEf/7YXx
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 Content-Transfer-Encoding: quoted-printable
 
 Uh, I think it refers to the idea of "class" introduced in the very
 first sentence of the geom(4) manual :)
 
 G'luck,
 Peter
 
 --=20
 Peter Pentchev	roam@ringlet.net roam@FreeBSD.org p.penchev@storpool.com
 PGP key:	http://people.FreeBSD.org/~roam/roam.key.asc
 Key fingerprint 2EE7 A7A5 17FC 124C F115  C354 651E EFB0 2527 DF13
 This sentence every third, but it still comprehensible.
 
 --E39vaYmALEf/7YXx
 Content-Type: application/pgp-signature; name="signature.asc"
 Content-Description: Digital signature
 
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.4.12 (GNU/Linux)
 
 iQIcBAEBCAAGBQJRVZVJAAoJEGUe77AlJ98TNokQAM5dS8KVaPfABECtWGzhbqZ4
 YzvUN+oy8FpwkgRFPk9N6yMKatJ2ZH3Rf+EJyLCHco2DyGmzFR6kSAWYoMPfa8nc
 C1scnVLr/u7G7npbBJnJZzxwwuBTexMFHptKJsbnYst7u+CLy+1DKqQR2jdHUnxM
 8nRiBC9kDQVyMy8B3cNclbe6hXxTdC2zdA0P5EtdXD/uuuVxAMGkNs5WwMNYc63z
 GIVG9dl2BmbBXzPsr11JxqwW/6OpZSAPQ4bG9CAya/jWGyvPeL1SG3ol6zsePhjk
 q0tvi6yDeVOiqrXus/ZJ8Wdlca3WKLVmJI2U0EeuOx1WbBxsmfk1BoUIxkG2NOzL
 P70IqXOSG6Hhq3wMlkrKIrp/a/rVRRgnfRLho/R1QR6YflT5LSIngmWWFrcytm09
 G/JbdnD1vKVq5JCYZOsA6zRVUGXv2NnHYKnr8hRTvBkJ7gthwFr9C0bXjK9nhlPL
 HWRLNGDj9O5aQv92EXo3YHXpX9sRVVjrubkLtj6brk1TTZgHowbC7tifed9+I0L1
 EXvCIHOgpDN8rimi1uDa2YVpYyLINNx690Fk5ZsoWOs6RwnWgq5MZP8dffNDsoCG
 cyUMFfTLfuK8vTEXRXKkaTsac5w2y9ENAjIwqJZrXS3UVmxI4IT839+2pXiDZGZa
 ncXYcfReprm1828RUU1c
 =wqf7
 -----END PGP SIGNATURE-----
 
 --E39vaYmALEf/7YXx--

From: "Ronald F. Guilmette" <rfg@tristatelogic.com>
To: Peter Pentchev <roam@ringlet.net>
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/177455: glabel(8) man page dangling verbal reference
Date: Fri, 29 Mar 2013 13:58:37 -0700

 In message <20130329132113.GB15952@straylight.m.ringlet.net>, you wrote:
 
 >Uh, I think it refers to the idea of "class" introduced in the very
 >first sentence of the geom(4) manual :)
 
 That sounds entirely reasonable, but for someone coming in cold, and
 just reading _only_ the glabel man page, the sentence in question
 is entirely cryptic.
 
 
 Regards,
 rfg
Responsible-Changed-From-To: freebsd-doc->joel 
Responsible-Changed-By: joel 
Responsible-Changed-When: Mon Apr 22 11:08:55 UTC 2013 
Responsible-Changed-Why:  
Take 

http://www.freebsd.org/cgi/query-pr.cgi?pr=177455 
State-Changed-From-To: open->closed 
State-Changed-By: joel 
State-Changed-When: Mon Apr 22 17:38:39 UTC 2013 
State-Changed-Why:  
I've committed a minor clarification to the manpage, but I don't think we can 
explain the word "class" in every single manpage. I'm closing this PR. Thanks. 

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

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/177455: commit references a PR
Date: Mon, 22 Apr 2013 17:38:33 +0000 (UTC)

 Author: joel (doc committer)
 Date: Mon Apr 22 17:38:26 2013
 New Revision: 249768
 URL: http://svnweb.freebsd.org/changeset/base/249768
 
 Log:
   Minor clarificiation.
   
   PR:		177455
 
 Modified:
   head/sbin/geom/class/label/glabel.8
 
 Modified: head/sbin/geom/class/label/glabel.8
 ==============================================================================
 --- head/sbin/geom/class/label/glabel.8	Mon Apr 22 15:51:06 2013	(r249767)
 +++ head/sbin/geom/class/label/glabel.8	Mon Apr 22 17:38:26 2013	(r249768)
 @@ -24,7 +24,7 @@
  .\"
  .\" $FreeBSD$
  .\"
 -.Dd June 13, 2009
 +.Dd April 22, 2013
  .Dt GLABEL 8
  .Os
  .Sh NAME
 @@ -81,7 +81,7 @@ The
  method uses on-disk metadata to store the label and detect it automatically in
  the future.
  .Pp
 -This class also provides volume label detection for file systems.
 +This GEOM class also provides volume label detection for file systems.
  Those labels cannot be set with
  .Nm ,
  but must be set with the appropriate file system utility, e.g.\& for UFS
 _______________________________________________
 svn-src-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-src-all
 To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
 
>Unformatted:
