From owner-freebsd-doc@FreeBSD.ORG Sat Aug 21 22:42:06 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id EF9D016A4CE for ; Sat, 21 Aug 2004 22:42:06 +0000 (GMT) Received: from arthur.nitro.dk (port324.ds1-khk.adsl.cybercity.dk [212.242.113.79]) by mx1.FreeBSD.org (Postfix) with ESMTP id 2859343D2D for ; Sat, 21 Aug 2004 22:42:06 +0000 (GMT) (envelope-from simon@arthur.nitro.dk) Received: by arthur.nitro.dk (Postfix, from userid 3000) id B6CBF11959; Sun, 22 Aug 2004 00:42:04 +0200 (CEST) Date: Sun, 22 Aug 2004 00:42:04 +0200 From: "Simon L. Nielsen" To: Atte Peltomaki Message-ID: <20040821224204.GC1149@arthur.nitro.dk> References: <20040820145251.GA36893@norsu.kameli.org> <20040820165602.GA737@norsu.kameli.org> <20040820144228.GB3997@orion.daedalusnetworks.priv> <20040820145359.GA16841@eddie.nitro.dk> <20040820184105.GA49742@norsu.kameli.org> <20040820202357.GA43134@norsu.kameli.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="lc9FT7cWel8HagAv" Content-Disposition: inline In-Reply-To: <20040820202357.GA43134@norsu.kameli.org> User-Agent: Mutt/1.5.6i cc: freebsd-doc@freebsd.org Subject: Re: Manpage for snd_solo X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 21 Aug 2004 22:42:07 -0000 --lc9FT7cWel8HagAv Content-Type: multipart/mixed; boundary="m51xatjYGsM+13rf" Content-Disposition: inline --m51xatjYGsM+13rf Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2004.08.20 20:23:57 +0000, Atte Peltomaki wrote: > > I'll regard these replies as "go ahead", so I'm starting work on > > snd_* and sound manpages asap. I'm expecting to have more done > > by the end of sunday. >=20 > I'm moving all "ready" stuff to http://kameli.org/man/ so please, > feel free to mail me any suggestions/corrections about the > pages. And keep in mind, this is my first day on the job ;) In general it looks very good, but there are a few mdoc(7) style issues which is fixed by the attached patch. BTW. there should also be a copyright/license thinggy in the files, preferably a two clause BSD license (e.g. like you see in the example manual pages). --=20 Simon L. Nielsen FreeBSD Documentation Team --m51xatjYGsM+13rf Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="snd.patch" Content-Transfer-Encoding: quoted-printable diff -ru snd.orig/snd_ad1816.4 snd/snd_ad1816.4 --- snd.orig/snd_ad1816.4 Fri Aug 20 19:18:18 2004 +++ snd/snd_ad1816.4 Sat Aug 21 22:28:26 2004 @@ -2,8 +2,8 @@ .Dt SND_AD1816 4 .Os .Sh NAME -.Nm snd_ad1816=20 -.Nd Analog Devices AD1816 ISA bridge device driver +.Nm snd_ad1816 +.Nd "Analog Devices AD1816 ISA bridge device driver" .Sh SYNOPSIS .Cd "device snd_ad1816" .Pp @@ -17,7 +17,7 @@ .Nm bridge driver allows the generic audio driver .Xr sound 4 -to attach to the AD1816 soundcard.=20 +to attach to the AD1816 soundcard. .Sh HARDWARE The .Nm @@ -35,6 +35,6 @@ manual page first appeared in .Fx 5.3 . .Sh AUTHORS -.An Cameron Grant cg@freebsd.org -.An Luigi Rizzo 1997,1998 -.An Hannu Savolainen 1994,1995 +.An "Cameron Grant" Aq cg@FreeBSD.org +.An "Luigi Rizzo" Aq luigi@FreeBSD.org +.An "Hannu Savolainen" diff -ru snd.orig/snd_als4000.4 snd/snd_als4000.4 --- snd.orig/snd_als4000.4 Fri Aug 20 19:18:18 2004 +++ snd/snd_als4000.4 Sat Aug 21 22:30:30 2004 @@ -2,8 +2,8 @@ .Dt SND_ALS4000 4 .Os .Sh NAME -.Nm snd_als4000=20 -.Nd Avance Logic ALS4000 PCI bridge device driver +.Nm snd_als4000 +.Nd "Avance Logic ALS4000 PCI bridge device driver" .Sh SYNOPSIS .Cd "device snd_als4000" .Pp @@ -12,7 +12,7 @@ .Nm bridge driver allows the generic audio driver .Xr sound 4 -to attach to the ALS4000 soundcard.=20 +to attach to the ALS4000 soundcard. .Sh HARDWARE The .Nm @@ -30,4 +30,4 @@ manual page first appeared in .Fx 5.3 . .Sh AUTHORS -.An Orion Hodson oho@acm.org +.An "Orion Hodson" Aq oho@acm.org diff -ru snd.orig/snd_cmi.4 snd/snd_cmi.4 --- snd.orig/snd_cmi.4 Fri Aug 20 19:18:18 2004 +++ snd/snd_cmi.4 Sat Aug 21 22:32:12 2004 @@ -2,8 +2,8 @@ .Dt SND_CMI 4 .Os .Sh NAME -.Nm snd_cmi=20 -.Nd CMedia CMI8338/CMI8738 PCI bridge device driver +.Nm snd_cmi +.Nd "CMedia CMI8338/CMI8738 PCI bridge device driver" .Sh SYNOPSIS .Cd "device snd_cmi" .Pp @@ -32,4 +32,4 @@ manual page first appeared in .Fx 5.3 . .Sh AUTHORS -.An Orion Hodson O.Hodson@cs.ucl.ac.uk +.An "Orion Hodson" Aq O.Hodson@cs.ucl.ac.uk diff -ru snd.orig/snd_cs4281.4 snd/snd_cs4281.4 --- snd.orig/snd_cs4281.4 Fri Aug 20 19:18:19 2004 +++ snd/snd_cs4281.4 Sat Aug 21 22:33:33 2004 @@ -2,8 +2,8 @@ .Dt SND_CS4281 4 .Os .Sh NAME -.Nm snd_cs4281=20 -.Nd Crystal Semiconductor CS4281 PCI bridge device driver +.Nm snd_cs4281 +.Nd "Crystal Semiconductor CS4281 PCI bridge device driver" .Sh SYNOPSIS .Cd "device snd_cs4281" .Pp @@ -12,7 +12,7 @@ .Nm bridge driver allows the generic audio driver .Xr sound 4 -to attach to the CS4281 soundcard.=20 +to attach to the CS4281 soundcard. .Sh HARDWARE The .Nm @@ -30,4 +30,4 @@ manual page first appeared in .Fx 5.3 . .Sh AUTHORS -.An Orion Hodson O.Hodson@cs.ucl.ac.uk +.An "Orion Hodson" Aq O.Hodson@cs.ucl.ac.uk diff -ru snd.orig/snd_csa.4 snd/snd_csa.4 --- snd.orig/snd_csa.4 Fri Aug 20 19:18:19 2004 +++ snd/snd_csa.4 Sat Aug 21 22:39:33 2004 @@ -2,8 +2,8 @@ .Dt SND_CSA 4 .Os .Sh NAME -.Nm snd_csa=20 -.Nd Crystal Semiconductor CS461x/462x/4280 PCI bridge device driver +.Nm snd_csa +.Nd "Crystal Semiconductor CS461x/462x/4280 PCI bridge device driver" .Sh SYNOPSIS .Cd "device snd_csa" .Pp @@ -12,7 +12,7 @@ .Nm bridge driver allows the generic audio driver .Xr sound 4 -to attach to the CS461x/462x/4280 soundcards.=20 +to attach to the CS461x/462x/4280 soundcards. .Sh HARDWARE The .Nm @@ -34,4 +34,4 @@ manual page first appeared in .Fx 5.3 . .Sh AUTHORS -.An Seigo Tanimura +.An "Seigo Tanimura" diff -ru snd.orig/snd_solo.4 snd/snd_solo.4 --- snd.orig/snd_solo.4 Fri Aug 20 19:18:19 2004 +++ snd/snd_solo.4 Sat Aug 21 22:42:56 2004 @@ -2,9 +2,8 @@ .Dt SND_SOLO 4 .Os .Sh NAME -.Nm snd_solo=20 -.Nd ESS=20 -Solo-1/1E PCI bridge device driver +.Nm snd_solo +.Nd "ESS Solo-1/1E PCI bridge device driver" .Sh SYNOPSIS .Cd "device snd_solo" .Pp @@ -13,7 +12,7 @@ .Nm bridge driver allows the generic audio driver .Xr sound 4 -to attach to the ESS Solo-1x PCI cards.=20 +to attach to the ESS Solo-1x PCI cards. .Sh HARDWARE The .Nm @@ -29,7 +28,7 @@ Note that older ESS ISA cards with ES18xx chipset are supported via .Xr snd_ess 4 and/or -.Xr snd_sbc 4 +.Xr snd_sbc 4 . .Sh SEE ALSO .Xr sound 4 .Sh HISTORY @@ -38,4 +37,4 @@ manual page first appeared in .Fx 5.3 . .Sh AUTHORS -.An Cameron Grant cg@freebsd.org +.An "Cameron Grant" Aq cg@FreeBSD.org --m51xatjYGsM+13rf-- --lc9FT7cWel8HagAv Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFBJ8+8h9pcDSc1mlERAp8rAKDCHgfeD1oYaFT/ev130XaBsEtHqQCcCXEA H80Uiau3DIWZMvBcpLXkeWI= =buo5 -----END PGP SIGNATURE----- --lc9FT7cWel8HagAv--