docs/177870: [patch] order EXAMPLE section in devfs(8) manpage

[Björn Heidotting]

>Number:         177870
>Category:       docs
>Synopsis:       [patch] order EXAMPLE section in devfs(8) manpage
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Apr 15 13:20:00 UTC 2013
>Closed-Date:
>Last-Modified:
>Originator:     Björn Heidotting
>Release:        FreeBSD 9.1
>Organization:
>Environment:
>Description:
In the devfs(8) manpage:
move EXAMPLES descriptions to before the actual command.
>How-To-Repeat:

>Fix:
A patch is included in this report.

Patch attached with submission follows:

--- devfs.8	2013-04-15 14:54:17.000000000 +0200
+++ devfs_work.8	2013-04-15 14:48:27.000000000 +0200
@@ -269,13 +269,11 @@
 .Pa /dev
 (this only matters for things that might change the properties of nodes).
 .Pp
-.Dl "devfs ruleset 10"
-.Pp
 Specify that ruleset 10 should be the current ruleset for
 .Pa /dev
 (if it does not already exist, it is created).
 .Pp
-.Dl "devfs rule add path speaker mode 666"
+.Dl "devfs ruleset 10"
 .Pp
 Add a rule that causes all nodes that have a path that matches
 .Dq Li speaker
@@ -293,7 +291,7 @@
 .Pa atspeaker
 module is loaded after the above rule is added).
 .Pp
-.Dl "devfs rule applyset"
+.Dl "devfs rule add path speaker mode 666"
 .Pp
 Apply all the rules in the current ruleset to all the existing nodes.
 E.g., if the above rule was added after
@@ -302,7 +300,7 @@
 this command will cause its file mode to be changed to 666
 as prescribed by the rule.
 .Pp
-.Dl devfs rule add path "snp*" mode 660 group snoopers
+.Dl "devfs rule applyset"
 .Pp
 (Quoting the argument to
 .Cm path
@@ -317,7 +315,7 @@
 .Xr snp 4
 devices.
 .Pp
-.Dl "devfs rule -s 20 add type disk group wheel"
+.Dl devfs rule add path "snp*" mode 660 group snoopers
 .Pp
 Add a rule to ruleset number 20.
 Since this ruleset is not the current ruleset for any mount-points,
@@ -325,34 +323,34 @@
 a current ruleset for some mount-point at a later time).
 However, it can be applied explicitly, as such:
 .Pp
-.Dl "devfs -m /my/jail/dev rule -s 20 applyset"
+.Dl "devfs rule -s 20 add type disk group wheel"
 .Pp
 This will apply all rules in ruleset number 20 to the DEVFS mount on
 .Pa /my/jail/dev .
 It does not matter that ruleset 20 is not the current ruleset for that
 mount-point; the rules are still applied.
 .Pp
-.Dl "devfs rule apply hide"
+.Dl "devfs -m /my/jail/dev rule -s 20 applyset"
 .Pp
 Since this rule has no conditions, the action
 .Pq Cm hide
 will be applied to all nodes.
 Since hiding all nodes is not very useful, we can undo it:
 .Pp
-.Dl "devfs rule apply unhide"
+.Dl "devfs rule apply hide"
 .Pp
 which applies
 .Cm unhide
 to all the nodes,
 causing them to reappear.
 .Pp
-.Dl "devfs rule -s 10 add - < my_rules"
+.Dl "devfs rule apply unhide"
 .Pp
 Add all the rules from the file
 .Pa my_rules
 to ruleset 10.
 .Pp
-.Dl "devfs rule -s 20 show | devfs rule -s 10 add -"
+.Dl "devfs rule -s 10 add - < my_rules"
 .Pp
 Since
 .Cm show
@@ -362,6 +360,8 @@
 The rule numbers are preserved,
 but ruleset 10 may already have rules with non-conflicting numbers
 (these will be preserved).
+.Pp
+.Dl "devfs rule -s 20 show | devfs rule -s 10 add -"
 .Sh SEE ALSO
 .Xr chmod 1 ,
 .Xr jail 2 ,


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