From rsmith@xs4all.nl  Thu Dec 23 14:51:05 2004
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 972D216A4CE
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 23 Dec 2004 14:51:05 +0000 (GMT)
Received: from smtp-vbr3.xs4all.nl (smtp-vbr3.xs4all.nl [194.109.24.23])
	by mx1.FreeBSD.org (Postfix) with ESMTP id AA2D443D4C
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 23 Dec 2004 14:51:04 +0000 (GMT)
	(envelope-from rsmith@xs4all.nl)
Received: from slackbox.xs4all.nl (slackbox.xs4all.nl [213.84.242.160])
	by smtp-vbr3.xs4all.nl (8.12.11/8.12.11) with ESMTP id iBNEp3dC026499
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 23 Dec 2004 15:51:03 +0100 (CET)
	(envelope-from rsmith@xs4all.nl)
Received: by slackbox.xs4all.nl (Postfix, from userid 1001)
	id E80146101; Thu, 23 Dec 2004 15:51:15 +0100 (CET)
Message-Id: <20041223145115.E80146101@slackbox.xs4all.nl>
Date: Thu, 23 Dec 2004 15:51:15 +0100 (CET)
From: Roland Smith <rsmith@xs4all.nl>
Reply-To: Roland Smith <rsmith@xs4all.nl>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: No manual pages for devfs.conf and devfs.rules
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         75433
>Category:       docs
>Synopsis:       No manual pages for devfs.conf and devfs.rules
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    keramida
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Thu Dec 23 15:00:44 GMT 2004
>Closed-Date:    Wed Jul 27 12:05:31 GMT 2005
>Last-Modified:  Wed Jul 27 12:05:31 GMT 2005
>Originator:     Roland Smith
>Release:        FreeBSD 5.3-RELEASE amd64
>Organization:
>Environment:
System: FreeBSD slackbox.xs4all.nl 5.3-RELEASE FreeBSD 5.3-RELEASE #1: Tue Dec 21 13:45:41 CET 2004 rsmith@slackbox.xs4all.nl:/usr/obj/usr/src/sys/RFS_1 amd64


>Description:
	There are no manual pages available for devfs.conf (see also PR 63808)  and devfs.rules.
>How-To-Repeat:
	man devfs.conf; man devfs.rules
>Fix:

	Based on my understanding of devfs(8) and the rc scripts, I've
	written these manual pages. You can download them from the
	following location: http://www.xs4all.nl/~rsmith/freebsd/ I would
	like to submit them for inclusion.


>Release-Note:
>Audit-Trail:

From: Roland Smith <rsmith@xs4all.nl>
To: bug-followup@freebsd.org
Cc:  
Subject: [PATCH] Re: docs/75433: No manpage for devfs.rules
Date: Sat, 30 Apr 2005 10:05:21 +0200

 --0/kgSOzhNoDC5T3a
 Content-Type: multipart/mixed; boundary="1ccMZA6j1vT5UqiK"
 Content-Disposition: inline
 
 
 --1ccMZA6j1vT5UqiK
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 Content-Transfer-Encoding: quoted-printable
 
 Attached is a manpage for devfs.rules. Could this be included in 5.4?
 
 Together with my post re docs/63808 this should close both PRs.
 
 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
 
 --1ccMZA6j1vT5UqiK
 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 .
 
 --1ccMZA6j1vT5UqiK--
 
 --0/kgSOzhNoDC5T3a
 Content-Type: application/pgp-signature
 Content-Disposition: inline
 
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.4.1 (FreeBSD)
 
 iD8DBQFCczxBEnfvsMMhpyURAlFxAJ9dFml8dAG3L3iii6bLG7jQTresPwCfQY0S
 CPAOchUbuDAwYQ8e1N1d8zc=
 =fo/0
 -----END PGP SIGNATURE-----
 
 --0/kgSOzhNoDC5T3a--
Responsible-Changed-From-To: freebsd-doc->simon 
Responsible-Changed-By: simon 
Responsible-Changed-When: Sun May 1 08:53:54 GMT 2005 
Responsible-Changed-Why:  
I will work on this one. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=75433 
Responsible-Changed-From-To: simon->keramida 
Responsible-Changed-By: keramida 
Responsible-Changed-When: Tue May 17 17:43:48 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=75433 
State-Changed-From-To: open->patched 
State-Changed-By: keramida 
State-Changed-When: Tue May 17 17:54:44 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=75433 
State-Changed-From-To: patched->closed 
State-Changed-By: keramida 
State-Changed-When: Wed Jul 27 12:05:18 GMT 2005 
State-Changed-Why:  
Merged to 5.X 

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