On Mon, Aug 29, 2011 at 07:19:04AM -0400, Jared McNeill wrote: > Can you put the driver xrefs back in 'SEE ALSO'? I find it useful.
I prefer personally a clear list instead (particularly if we have more than 10 of these drivers some day). But sure. - Jukka. > -----Original Message----- > From: Jukka Ruohonen > Sent: Monday, August 29, 2011 6:41 AM Newsgroups: > gmane.os.netbsd.devel.cvs.full > To: source-changes-full-qavaossjccednm+yrof...@public.gmane.org > Subject: CVS commit: src/share/man/man4 > > Module Name: src > Committed By: jruoho > Date: Mon Aug 29 10:41:10 UTC 2011 > > Modified Files: > src/share/man/man4: dtv.4 > > Log Message: > Various improvements; e.g. primarily speak about DTV (i.e. DVB is just a > standard), split out SUPPORTED DEVICES from SEE ALSO, improve grammar, fix > references, speak about interface instead of device, fix AUTHORS, etc. > > > To generate a diff of this commit: > cvs rdiff -u -r1.2 -r1.3 src/share/man/man4/dtv.4 > > Please note that diffs are not public domain; they are subject to the > copyright notices on the relevant files. > > > > > > > > Modified files: > > Index: src/share/man/man4/dtv.4 > diff -u src/share/man/man4/dtv.4:1.2 src/share/man/man4/dtv.4:1.3 > --- src/share/man/man4/dtv.4:1.2 Sun Aug 14 20:42:09 2011 > +++ src/share/man/man4/dtv.4 Mon Aug 29 10:41:10 2011 > @@ -1,4 +1,4 @@ > -.\" $NetBSD: dtv.4,v 1.2 2011/08/14 20:42:09 wiz Exp $ > +.\" $NetBSD: dtv.4,v 1.3 2011/08/29 10:41:10 jruoho Exp $ > .\" > .\" Copyright (c) 2011 The NetBSD Foundation, Inc. > .\" All rights reserved. > @@ -32,7 +32,7 @@ > .Os > .Sh NAME > .Nm dtv > -.Nd DVB (digital video broadcasting) programming interface > +.Nd interface for digital television > .Sh SYNOPSIS > .Cd "dtv* at dtvbus?" > .Pp > @@ -40,38 +40,63 @@ > .In dev/dtv/dtvio_demux.h > .In dev/dtv/dtvio_frontend.h > .Sh DESCRIPTION > -The > +The machine-independent > +.Nm > +interface provides support for digital television > +.Pq Dv DTV . > +A subset of the Linux Digital Video Broadcasting > +.Pq Dv DVB > +.Dv APIs > +is supported. > +In particular, > .Nm > -driver provides support for a subset of the Linux DVB (digital > -video broadcasting) APIs; in particular, > +provides the DVB frontend and demodulator > +.Dv APIs . > +.Sh SUPPORTED DEVICES > +The following machine-independent devices are supported: > +.Bl -tag -width "auvitek(4) " -offset indent > +.It Xr auvitek 4 > +Auvitek AU0828-based video capture cards > +.It Xr coram 4 > +Hauppauge WinTV-HVR-1250 > +.It Xr xdtv 4 > +Conexant CX2388X-based DTV cards > +.It Xr emdtv 4 > +EM28XX-based DTV cards > +.El > +.Pp > +Note that the > .Nm > -provides the DVB Frontend API and the DVB Demux Device. > +device drivers are generally only available as kernel modules; see > +.Xr module 7 > +and > +.Xr modload 8 > +for additional details. > .Sh FILES > .Bl -tag -width 28n > .It Pa /dev/dvb/adapterN/frontend0 > The frontend device, for controlling the tuner and demodulator hardware. > .It Pa /dev/dvb/adapterN/demux0 > -The demux device, for controlling the DVB hardware's filters. > +The demux device, for controlling the hardware filters. > .It Pa /dev/dvb/adapterN/dvr0 > -Digital video recording device > +Digital video recording device. > .El > .Sh SEE ALSO > -.Xr auvitek 4 , > -.Xr coram 4 , > -.Xr cxdtv 4 , > -.Xr emdtv 4 , > +.Xr video 9 > +.Pp > .Pa pkgsrc/multimedia/dvb-apps , > .Pa pkgsrc/multimedia/mplayer , > -.Pa http://linuxtv.org/downloads/v4l-dvb-apis/dvbapi.html > +.Rs > +.%T Linux Media Infrastructure API. > +.%T Part II. Linux DVB API > +.%D 2011 > +.%U http://linuxtv.org/downloads/v4l-dvb-apis/dvbapi.html > +.Re > .Sh HISTORY > The > .Nm > -device driver first appeared in > +interface first appeared in > .Nx 6.0 . > .Sh AUTHORS > -.An -nosplit > -The > -.Nm > -driver was written by > .An Jared D. McNeill > -.Aq jmcneill-qavaossjccednm+yrof...@public.gmane.org . > +.Aq jmcneill-m2zzwtmgr3hafepfgvp...@public.gmane.org >