From rsmith@xs4all.nl  Fri Apr 29 16:24:20 2005
Return-Path: <rsmith@xs4all.nl>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 3AD1F16A4CE
	for <freebsd-gnats-submit@freebsd.org>; Fri, 29 Apr 2005 16:24:20 +0000 (GMT)
Received: from smtp-vbr2.xs4all.nl (smtp-vbr2.xs4all.nl [194.109.24.22])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 971CE43D53
	for <freebsd-gnats-submit@freebsd.org>; Fri, 29 Apr 2005 16:24:19 +0000 (GMT)
	(envelope-from rsmith@xs4all.nl)
Received: from slackbox.xs4all.nl (slackbox.xs4all.nl [213.84.242.160])
	by smtp-vbr2.xs4all.nl (8.12.11/8.12.11) with ESMTP id j3TGOG7U030792
	for <freebsd-gnats-submit@freebsd.org>; Fri, 29 Apr 2005 18:24:18 +0200 (CEST)
	(envelope-from rsmith@xs4all.nl)
Received: by slackbox.xs4all.nl (Postfix, from userid 1001)
	id 50BAC6398; Fri, 29 Apr 2005 18:24:16 +0200 (CEST)
Message-Id: <20050429162416.GB69413@slackbox.xs4all.nl>
Date: Fri, 29 Apr 2005 18:24:16 +0200
From: Roland Smith <rsmith@xs4all.nl>
To: freebsd-gnats-submit@freebsd.org
Subject: [patch] docs/75433: no manual page for devfs.rules.

>Number:         80459
>Category:       docs
>Synopsis:       [patch] docs/75433: no manual page for devfs.rules.
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    keramida
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          sw-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Apr 29 16:30:02 GMT 2005
>Closed-Date:    Wed Jul 27 12:06:00 GMT 2005
>Last-Modified:  Wed Jul 27 12:06:00 GMT 2005
>Originator:     
>Release:        
>Organization:
>Environment:
>Description:
 --tNQTSEo8WG/FKZ8E
 Content-Type: multipart/mixed; boundary="NKoe5XOeduwbEQHU"
 Content-Disposition: inline
 
 
 --NKoe5XOeduwbEQHU
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 Content-Transfer-Encoding: quoted-printable
 
 Please find attached a manual page for devfs.rules. I've already sent a
 manual page for devfs.conf in response to docs/63808.
 
 Could this be included in 5.4?
 
 Roland
 --=20
 R.F. Smith                           /"\    ASCII Ribbon Campaign
 r s m i t h @ x s 4 a l l . n l      \ /    No HTML/RTF in e-mail
 http://www.xs4all.nl/~rsmith/         X     No Word docs in e-mail
 public key: http://www.keyserver.net / \    Respect for open standards
 
 --NKoe5XOeduwbEQHU
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: attachment; filename="devfs.rules.5"
 Content-Transfer-Encoding: quoted-printable
 
 =2E\" Copyright (c) 2004 Roland Smith <rsmith@xs4all.nl>
 =2E\" All rights reserved.
 =2E\"
 =2E\" Redistribution and use in source and binary forms, with or without
 =2E\" modification, are permitted provided that the following conditions
 =2E\" are met:
 =2E\" 1. Redistributions of source code must retain the above copyright
 =2E\"    notice, this list of conditions and the following disclaimer.
 =2E\" 2. Redistributions in binary form must reproduce the above copyright
 =2E\"    notice, this list of conditions and the following disclaimer in the
 =2E\"    documentation and/or other materials provided with the distributio=
 n.
 =2E\"
 =2E\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND
 =2E\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 =2E\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PU=
 RPOSE
 =2E\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE
 =2E\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUE=
 NTIAL
 =2E\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOO=
 DS
 =2E\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 =2E\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, S=
 TRICT
 =2E\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY=
  WAY
 =2E\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 =2E\" SUCH DAMAGE.
 =2E\"
 =2E\" $FreeBSD$
 =2E\"
 =2EDd December 23, 2004
 =2EDt DEVFS.RULES 5
 =2EOs
 =2ESh NAME
 =2ENm devfs.rules
 =2ENd devfs configuration information
 =2ESh DESCRIPTION
 The
 =2ENm
 file provides an easy way to create and apply
 =2EXr devfs 8
 rules, even for devices that are not available at boot.
 =2EPp
 For devices available at boot, see=20
 =2EXr devfs.conf 5 .
 =2EPp
 The format of this file is simple. Empty lines and lines beginning with a
 hash sign '#' are ignored. A line between brackets denotes the start of a
 ruleset. In the brackets should be the name of the ruleset and its number,
 separated by an equal sign.
 =2EPp
 Other lines are rule specifications as documented in
 =2EXr devfs 8 ,
 in the section "Rule Specification". These lines are prepended with 'rule'
 and passed to
 =2EXr devfs 8 .
 by the rc scripts. It is important to put=20
 =2EPa path
 elements that contain
 =2EXr glob 3
 special characters between quotes, to prevent them from being expanded by
 the shell.
 =2ESh EXAMPLES
 =2EBl -tag
 =2EIt Li "add path 'da*s*' mode 0660 group usb"
 makes all partitions of
 =2EXr da 4
 devices read- and writable by the owner and the group usb.
 =2EIt Li "add path 'uscanner*' mode 0660 group usb"
 makes all=20
 =2EXr uscanner 4
 devices accessible to the owner and the group usb.
 =2EEl
 =2ESh FILES
 =2EBl -tag -compact
 =2EIt Pa /etc/devfs.rules
 =2EIt Pa /etc/defaults/devfs.rules
 =2EEl
 =2ESh SEE ALSO
 =2EXr devfs 8 ,
 =2EXr devfs 5 ,
 =2EXr devfs.conf 5 ,
 =2EXr glob 3
 =2ESh AUTHORS
 =2EAn "Roland Smith" Aq rsmith@xs4all.nl .
 
 --NKoe5XOeduwbEQHU--
 
 --tNQTSEo8WG/FKZ8E
 Content-Type: application/pgp-signature
 Content-Disposition: inline
 
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.4.1 (FreeBSD)
 
 iD8DBQFCcl+wEnfvsMMhpyURAqUDAJ4sbqZTOeG1N9QZYa+SnQ2sJdlQXgCgjQfu
 SM5H6SVWENQ7Z1Ak/2yFTQE=
 =7uXR
 -----END PGP SIGNATURE-----
 
 --tNQTSEo8WG/FKZ8E--
>How-To-Repeat:
>Fix:
>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: gnats-admin->freebsd-doc 
Responsible-Changed-By: linimon 
Responsible-Changed-When: Mon May 2 01:41:44 GMT 2005 
Responsible-Changed-Why:  
Rescue this PR from the 'pending' category. 

However, since the patch was sent using quoted-printable, it is 
probably too mangled to be used. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=80459 
Responsible-Changed-From-To: freebsd-doc->simon 
Responsible-Changed-By: remko 
Responsible-Changed-When: Mon May 2 15:44:16 GMT 2005 
Responsible-Changed-Why:  
Simon grabbed these PR's. So my guess is this should stick along. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=80459 
Responsible-Changed-From-To: simon->keramida 
Responsible-Changed-By: keramida 
Responsible-Changed-When: Tue May 17 17:44:06 GMT 2005 
Responsible-Changed-Why:  
Grab this PR from Simon.  I have a version of the manpages ready for commit    
and he said it's ok to get these PRs off him.  

http://www.freebsd.org/cgi/query-pr.cgi?pr=80459 
State-Changed-From-To: open->patched 
State-Changed-By: keramida 
State-Changed-When: Tue May 17 17:55:03 GMT 2005 
State-Changed-Why:  
Committed to CURRENT.  I'll MFC these after a few days :-) 

http://www.freebsd.org/cgi/query-pr.cgi?pr=80459 
State-Changed-From-To: patched->closed 
State-Changed-By: keramida 
State-Changed-When: Wed Jul 27 12:05:47 GMT 2005 
State-Changed-Why:  
Merged to 5.X 

http://www.freebsd.org/cgi/query-pr.cgi?pr=80459 
>Unformatted:
