Re: CVS commit: src/share/man/man4

[Jukka Ruohonen <jruohonen%iki.fi@localhost>]

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+yROfE0A%public.gmane.org@localhost
> 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+yROfE0A%public.gmane.org@localhost .
> +.Aq jmcneill-m2zzWtmgR3hAFePFGvp55w%public.gmane.org@localhost
>