svn commit: r204166 - in head: sbin/devfs share/man/man5

[Gavin Atkinson]

Author: gavin
Date: Sun Feb 21 10:29:45 2010
New Revision: 204166
URL: http://svn.freebsd.org/changeset/base/204166

Log:
  Document the interaction between /etc/devfs.conf and
  /etc/defaults/devfs.conf
  
  PR:		docs/117308
  Submitted by:	Mel <mel.xyzzy rachie.is-a-geek.net> (partially)
  MFC after:	1 week

Modified:
  head/sbin/devfs/devfs.8
  head/share/man/man5/devfs.rules.5

Modified: head/sbin/devfs/devfs.8
==============================================================================
--- head/sbin/devfs/devfs.8	Sun Feb 21 10:14:06 2010	(r204165)
+++ head/sbin/devfs/devfs.8	Sun Feb 21 10:29:45 2010	(r204166)
@@ -25,7 +25,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd June 27, 2008
+.Dd February 21, 2010
 .Dt DEVFS 8
 .Os
 .Sh NAME
@@ -196,6 +196,9 @@ Apply all the rules in ruleset number
 to the node.
 This does not necessarily result in any changes to the node
 (e.g., if none of the rules in the included ruleset match).
+Include commands in the referenced
+.Ar ruleset
+are not resolved.
 .It Cm mode Ar filemode
 Set the file mode to
 .Ar filemode ,
@@ -243,7 +246,9 @@ configuration file.
 .It Pa /etc/devfs.rules
 Local
 .Nm
-configuration file.
+configuration file.  Rulesets in here override those in
+.Pa /etc/defaults/devfs.rules 
+with the same ruleset number, otherwise the two files are effectively merged. 
 .It Pa /etc/devfs.conf
 Boot-time
 .Nm

Modified: head/share/man/man5/devfs.rules.5
==============================================================================
--- head/share/man/man5/devfs.rules.5	Sun Feb 21 10:14:06 2010	(r204165)
+++ head/share/man/man5/devfs.rules.5	Sun Feb 21 10:29:45 2010	(r204166)
@@ -24,7 +24,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd January 30, 2006
+.Dd February 21, 2010
 .Dt DEVFS.RULES 5
 .Os
 .Sh NAME
@@ -83,8 +83,16 @@ devfs_system_ruleset="localrules"
 .Ed
 .Sh FILES
 .Bl -tag -compact
-.It Pa /etc/devfs.rules
 .It Pa /etc/defaults/devfs.rules
+Default
+.Nm
+configuration file.
+.It Pa /etc/devfs.rules
+Local
+.Nm
+configuration file. Rulesets in here override those in
+.Pa /etc/defaults/devfs.rules
+with the same ruleset number, otherwise the two files are effectively merged.
 .El
 .Sh EXAMPLES
 To make all the partitions of