Manpage for snd_solo

Sat Aug 21 22:42:07 UTC 2004

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

-- 
Simon L. Nielsen
FreeBSD Documentation Team
-------------- next part --------------
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 
-.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. 
+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 at freebsd.org
-.An Luigi Rizzo 1997,1998
-.An Hannu Savolainen 1994,1995
+.An "Cameron Grant" Aq cg at FreeBSD.org
+.An "Luigi Rizzo" Aq luigi at 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 
-.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. 
+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 at acm.org
+.An "Orion Hodson" Aq oho at 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 
-.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 at cs.ucl.ac.uk
+.An "Orion Hodson" Aq O.Hodson at 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 
-.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. 
+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 at cs.ucl.ac.uk
+.An "Orion Hodson" Aq O.Hodson at 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 
-.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. 
+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 
-.Nd ESS 
-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. 
+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 at freebsd.org
+.An "Cameron Grant" Aq cg at FreeBSD.org
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: not available
URL: <http://lists.freebsd.org/pipermail/freebsd-doc/attachments/20040822/4d65ae4e/attachment.sig>
