Skip site navigation (1)Skip section navigation (2)
Date:      Sun, 22 Aug 2004 00:42:04 +0200
From:      "Simon L. Nielsen" <simon@FreeBSD.org>
To:        Atte Peltomaki <koston@iki.fi>
Cc:        freebsd-doc@freebsd.org
Subject:   Re: Manpage for snd_solo
Message-ID:  <20040821224204.GC1149@arthur.nitro.dk>
In-Reply-To: <20040820202357.GA43134@norsu.kameli.org>
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>

next in thread | previous in thread | raw e-mail | index | archive | help

--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--


Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20040821224204.GC1149>