From rsmith@xs4all.nl  Fri Apr 29 16:20:48 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 9568C16A4CE
	for <freebsd-gnats-submit@freebsd.org>; Fri, 29 Apr 2005 16:20:48 +0000 (GMT)
Received: from smtp-vbr9.xs4all.nl (smtp-vbr9.xs4all.nl [194.109.24.29])
	by mx1.FreeBSD.org (Postfix) with ESMTP id AB93D43D2F
	for <freebsd-gnats-submit@freebsd.org>; Fri, 29 Apr 2005 16:20:47 +0000 (GMT)
	(envelope-from rsmith@xs4all.nl)
Received: from slackbox.xs4all.nl (slackbox.xs4all.nl [213.84.242.160])
	by smtp-vbr9.xs4all.nl (8.12.11/8.12.11) with ESMTP id j3TGKkui043636
	for <freebsd-gnats-submit@freebsd.org>; Fri, 29 Apr 2005 18:20:46 +0200 (CEST)
	(envelope-from rsmith@xs4all.nl)
Received: by slackbox.xs4all.nl (Postfix, from userid 1001)
	id D427B6398; Fri, 29 Apr 2005 18:20:45 +0200 (CEST)
Message-Id: <20050429162045.GA69413@slackbox.xs4all.nl>
Date: Fri, 29 Apr 2005 18:20:45 +0200
From: Roland Smith <rsmith@xs4all.nl>
To: freebsd-gnats-submit@freebsd.org
Subject: [PATCH] docs/63808: No manpage for devfs.conf

>Number:         80458
>Category:       docs
>Synopsis:       [PATCH] docs/63808: No manpage for devfs.conf
>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:05:46 GMT 2005
>Last-Modified:  Wed Jul 27 12:05:46 GMT 2005
>Originator:     
>Release:        
>Organization:
>Environment:
>Description:
 --VrqPEDrXMn8OVzN4
 Content-Type: multipart/mixed; boundary="AqsLC8rIMeq19msA"
 Content-Disposition: inline
 
 
 --AqsLC8rIMeq19msA
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 Content-Transfer-Encoding: quoted-printable
 
 Attached is a manual page for devfs.conf. Would it be possible to get it
 into 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
 
 --AqsLC8rIMeq19msA
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: attachment; filename="devfs.conf.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.CONF 5
 =2EOs
 =2ESh NAME
 =2ENm devfs.conf
 =2ENd boot-time devfs configuration information
 =2ESh DESCRIPTION
 The
 =2ENm
 file provides an easy way to set ownership and premissions and create links
 for devices available at boot.
 =2EPp
 It does not work for devices plugged in and out during operations, e.g. usb
 devices. See
 =2EXr devfs.rules 5
 for setting ownership and permissions for all device nodes, and
 =2EXr usbd.conf 5=20
 for actions to be taken when USB devices are attached or detached.
 =2EPp
 Lines starting with a hash sign '#' and empty lines are ignored. Lines
 consist of three parameters separated by whitespace. The first parameter is
 always the action to take, the second is always the existing device created
 by devfs, and the last is the argument to the action. Possible actions are
 =2EPa link ,
 =2EPa own
 and
 =2EPa perm.
 The name of the action is only significant to the first unique character.
 =2EPp
 The
 =2EPa link
 action creates a symbolic link from a device created by devfs to the name
 you specified as the third parameter.
 =2EPp
 The=20
 =2EPa own
 action changes the ownership of a device. The third parameter must be in
 the form of an <owner>:<group> pair as in
 =2EXr chown 8 .
 =2EPp
 The=20
 =2EPa perm
 action changes the permissions of a device. The third paramater must be a
 =2EPa mode
 as explained in
 =2EXr chmod 1 .
 =2ESh EXAMPLES
 =2EBl -tag -width "own cd0 root:cdrom"
 =2EIt Li "link cd0 cdrom"
 create a link named
 =2EPa cdrom
 to the
 =2EPa cd0
 device.
 =2EIt Li "own cd0 root:cdrom"
 set the group for the
 =2EPa cd0
 device to
 =2EPa cdrom .
 =2EIt Li "perm cd0 0660"
 make the
 =2EPa cd0
 device owner and group read- and writable.
 =2EEl
 =2ESh FILES
 =2EBl -tag -compact
 =2EIt Pa /etc/devfs.conf
 =2EIt Pa /usr/share/examples/etc/devfs.conf
 =2EEl
 =2ESh SEE ALSO
 =2EXr chmod 1 ,
 =2EXr chown 8 ,
 =2EXr devfs 8 ,
 =2EXr devfs 5 ,
 =2EXr devfs.rules 5 ,
 =2EXr usbd.conf 5
 =2ESh AUTHORS
 =2EAn "Roland Smith" Aq rsmith@xs4all.nl .
 
 --AqsLC8rIMeq19msA--
 
 --VrqPEDrXMn8OVzN4
 Content-Type: application/pgp-signature
 Content-Disposition: inline
 
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.4.1 (FreeBSD)
 
 iD8DBQFCcl7dEnfvsMMhpyURAiESAJ0axuSlkUgMBPAPs5GEoxjXwKlzQQCghPRS
 d7L1xhZDUGN9fOW8sUgMqME=
 =rLUn
 -----END PGP SIGNATURE-----
 
 --VrqPEDrXMn8OVzN4--
>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:38:53 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=80458 
Responsible-Changed-From-To: freebsd-doc->simon 
Responsible-Changed-By: remko 
Responsible-Changed-When: Mon May 2 15:43:43 GMT 2005 
Responsible-Changed-Why:  
Simon grabbed these PR's, so my guess is this should be with him as well. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=80458 

From: Roland Smith <rsmith@xs4all.nl>
To: bug-followup@freebsd.org
Cc:  
Subject: Re: docs/80458
Date: Sat, 7 May 2005 14:00:38 +0200

 --rQ2U398070+RC21q
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 Content-Transfer-Encoding: quoted-printable
 
 If the attached manual page is too mangled by the quoted-printable
 encoding, please fetch it from my freebsd page:
 http://www.xs4all.nl/~rsmith/freebsd/
 
 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
 
 --rQ2U398070+RC21q
 Content-Type: application/pgp-signature
 Content-Disposition: inline
 
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.4.1 (FreeBSD)
 
 iD8DBQFCfK3mEnfvsMMhpyURAipuAJkB1efMpfDA/Rix0OzVz1u+BOGbAwCeI3O2
 bejKQBQmxcsFgzEH8YZg5E4=
 =8WXo
 -----END PGP SIGNATURE-----
 
 --rQ2U398070+RC21q--
Responsible-Changed-From-To: simon->keramida 
Responsible-Changed-By: keramida 
Responsible-Changed-When: Tue May 17 17:44:30 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=80458 
State-Changed-From-To: open->patched 
State-Changed-By: keramida 
State-Changed-When: Tue May 17 17:55:23 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=80458 
State-Changed-From-To: patched->closed 
State-Changed-By: keramida 
State-Changed-When: Wed Jul 27 12:05:34 GMT 2005 
State-Changed-Why:  
Merged to 5.X 

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