From ws@ovirt.dyndns.ws  Fri Mar  5 09:18:39 2004
Return-Path: <ws@ovirt.dyndns.ws>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id CB5E916A4CE
	for <FreeBSD-gnats-submit@freebsd.org>; Fri,  5 Mar 2004 09:18:39 -0800 (PST)
Received: from ovirt.dyndns.ws (ppp36-152.lns1.adl1.internode.on.net [150.101.36.152])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 5E89B43D46
	for <FreeBSD-gnats-submit@freebsd.org>; Fri,  5 Mar 2004 09:18:37 -0800 (PST)
	(envelope-from ws@ovirt.dyndns.ws)
Received: from ovirt.dyndns.ws (localhost [127.0.0.1])
	by ovirt.dyndns.ws (8.12.10/8.12.10) with ESMTP id i25HJBUf059338
	for <FreeBSD-gnats-submit@freebsd.org>; Sat, 6 Mar 2004 03:49:11 +1030 (CST)
	(envelope-from ws@ovirt.dyndns.ws)
Received: (from root@localhost)
	by ovirt.dyndns.ws (8.12.10/8.12.10/Submit) id i25HJBTa059337;
	Sat, 6 Mar 2004 03:49:11 +1030 (CST)
	(envelope-from ws)
Message-Id: <200403051719.i25HJBTa059337@ovirt.dyndns.ws>
Date: Sat, 6 Mar 2004 03:49:11 +1030 (CST)
From: ws+freebsd-gnats-submit@au.dyndns.ws
Reply-To: ws+freebsd-gnats-submit@au.dyndns.ws
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: No manpage for devfs.conf
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         63808
>Category:       docs
>Synopsis:       No manpage for devfs.conf
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    keramida
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Mar 05 09:20:15 PST 2004
>Closed-Date:    Wed Jul 27 12:05:15 GMT 2005
>Last-Modified:  Wed Jul 27 12:05:15 GMT 2005
>Originator:     Wayne Sierke
>Release:        FreeBSD 5.2-RELEASE i386
>Organization:
>Environment:
System: FreeBSD predator-ii 5.2-RELEASE FreeBSD 5.2-RELEASE #0: Wed Feb 18 08:38:10 CST 2004 root@predator-ii:/usr/src/sys/i386/compile/PREDATOR-II i386
>Description:
	No manpage exists for /etc/devfs.conf
>How-To-Repeat:
	$ man devfs.conf
        No manual entry for devfs.conf
>Fix:
	If this were the future, I might say: "Here's one I prepared earlier." Alas, no.
        Hopefully if one is created, suitable references will be added to eg. man devfs(8)
>Release-Note:
>Audit-Trail:

From: Roland Smith <rsmith@xs4all.nl>
To: freebsd-gnats-submit@freebsd.org, freebsd-doc@freebsd.org
Cc: ws+freebsd-gnats-submit@au.dyndns.ws
Subject: Re: docs/63808: No manpage for devfs.conf
Date: Mon, 13 Dec 2004 00:07:49 +0100

 --ikeVEW9yuYc//A+q
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 Content-Transfer-Encoding: quoted-printable
 
 Hi,
 
 I have recently switched to FreeBSD. Although IMHO FreeBSD is very well
 documented, with lots of excellent manual pages, I really missed manual
 pages for devfs.conf and devfs.rules.
 
 So I created them, based on my reading of other manual pages and the
 startup scripts. You can find them at the following URI:
 http://www.xs4all.nl/~rsmith/freebsd/
 
 I would like to ask for feedback on these manual pages. In particular I
 would like to know what needs to be done to make them suitable for
 submission, and whom I should submit them to when finished, since manual
 pages are not deemed to be part of the documentation set.
 
 Although I've tried to adhere to groff_mdoc(7) and have used other
 manual pages as examples, the lists in the examples in devfs.conf.5 and
 devfs.rules.5 come out mangled when rendering in HTML. Text and
 PostScript look fine. Am I doing something wrong, or is this a bug?
 
 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 email
 http://www.xs4all.nl/~rsmith/         X     No Word docs in email
                                      / \    Respect for open standards
 
 --ikeVEW9yuYc//A+q
 Content-Type: application/pgp-signature
 Content-Disposition: inline
 
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.2.6 (FreeBSD)
 
 iD8DBQFBvM9FEnfvsMMhpyURAnspAKCsxkxYKYtV1X7FXiLveSe17inC2ACcCN4Y
 dwyinrhcxbnhL82UeAlyUU0=
 =exh8
 -----END PGP SIGNATURE-----
 
 --ikeVEW9yuYc//A+q--

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

 --dc+cDN39EJAMEtIO
 Content-Type: multipart/mixed; boundary="n8g4imXOkfNTN/H1"
 Content-Disposition: inline
 
 
 --n8g4imXOkfNTN/H1
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 Content-Transfer-Encoding: quoted-printable
 
 Attached is a manpage for devfs.conf. 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
 
 --n8g4imXOkfNTN/H1
 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 .
 
 --n8g4imXOkfNTN/H1--
 
 --dc+cDN39EJAMEtIO
 Content-Type: application/pgp-signature
 Content-Disposition: inline
 
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.4.1 (FreeBSD)
 
 iD8DBQFCczuxEnfvsMMhpyURAgM6AKCc6MKM4WD3RTfwwnxrkDIh5Tz5DwCeLImH
 2/New4tEiQBfDr58NZTpvnk=
 =GpPZ
 -----END PGP SIGNATURE-----
 
 --dc+cDN39EJAMEtIO--
Responsible-Changed-From-To: freebsd-doc->simon 
Responsible-Changed-By: simon 
Responsible-Changed-When: Sat Apr 30 08:29:49 GMT 2005 
Responsible-Changed-Why:  
I will work on this. 

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

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