Bug 177455

Summary: glabel(8) man page dangling verbal reference
Product: Documentation Reporter: Ronald F. Guilmette <rfg>
Component: Books & ArticlesAssignee: Joel Dahl <joel>
Status: Closed FIXED    
Severity: Affects Only Me CC: rfg
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Ronald F. Guilmette 2013-03-28 23:10:00 UTC 
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. :-)

Fix: 

Edit man page.
How-To-Repeat: 
man 8 glabel
Comment 1 Peter Pentchev 2013-03-29 13:21:14 UTC 
Uh, I think it refers to the idea of "class" introduced in the very
first sentence of the geom(4) manual :)

G'luck,
Peter

-- 
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.
Comment 2 Ronald F. Guilmette 2013-03-29 20:58:37 UTC 
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
Comment 3 Joel Dahl freebsd_committer freebsd_triage 2013-04-22 12:08:55 UTC 
Responsible Changed
From-To: freebsd-doc->joel

Take
Comment 4 dfilter service freebsd_committer freebsd_triage 2013-04-22 18:38:33 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"
Comment 5 Joel Dahl freebsd_committer freebsd_triage 2013-04-22 18:38:39 UTC 
State Changed
From-To: open->closed

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.