docs/90362: [patch] enhancement of devfs.rules manpage.

[Roland Smith]

>Number:         90362
>Category:       docs
>Synopsis:       [patch] enhancement of devfs.rules manpage.
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Tue Dec 13 21:50:02 GMT 2005
>Closed-Date:
>Last-Modified:
>Originator:     Roland Smith
>Release:        FreeBSD 6.0-STABLE amd64
>Organization:
>Environment:
System: FreeBSD slackbox.xs4all.nl 6.0-STABLE FreeBSD 6.0-STABLE #0: Sun Nov 20 02:27:45 CET 2005 root at slackbox.xs4all.nl:/usr/obj/usr/src/sys/RFS amd64


	
>Description:
	As a result of recent postings on -questions, it became clear that
	the manpage for devfs.rules could be improved, especially
	mentioning that a ruleset needs to be activated in
	/etc/rc.conf. This patch tries to provide such improvement.

>How-To-Repeat:
	
>Fix:

See enclosed patch. Feel free to improve the tags used, I'm still learning
mdoc. :-)
----------------------- patch ----------------------------
--- devfs.rules.5	2005/12/13 19:59:29	1.6
+++ devfs.rules.5	2005/12/13 21:19:53
@@ -24,7 +24,7 @@
 .\"
 .\" $FreeBSD: /repoman/r/ncvs/src/share/man/man5/devfs.rules.5,v 1.2.4.1 2005/07/27 12:03:48 keramida Exp $
 .\"
-.Dd May 17, 2005
+.Dd Dec 13, 2005
 .Dt DEVFS.RULES 5
 .Os
 .Sh NAME
@@ -72,8 +72,23 @@
 .Dq Li usb
 group, the following rule may be used:
 .Pp
+.Dl "[localrules=10]"
 .Dl "add path 'da*s*' mode 0660 group usb"
 .Pp
+The first line declares and starts a new ruleset, with the name
+.Va localrules
+and the number 10. Rulesets should have a unique name and number.  All
+rules that follow a ruleset declaration belong to that ruleset, untill a
+new ruleset is started. This ruleset has to be enabled in
+.Pa /etc/rc.conf 
+to be the ruleset for the 
+.Pa /dev 
+filesystem. This is done by putting the following line in 
+.Pa /etc/rc.conf :
+.Bd -literal
+devfs_system_ruleset="localrules"
+.Ed
+.Pp
 To make all the
 .Xr uscanner 4
 devices accessible to their owner and the
@@ -81,6 +96,7 @@
 group, a similar rule may be used:
 .Pp
 .Dl "add path 'uscanner*' mode 0660 group usb"
+.Pp
 .Sh SEE ALSO
 .Xr glob 3 ,
 .Xr devfs 5 ,
----------------------- patch ----------------------------


>Release-Note:
>Audit-Trail:
>Unformatted: