[src/trunk]: src/share/man/man4 Some improvements.

[jruoho <jruoho%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/9aaa37e6ebc6
branches:  trunk
changeset: 768972:9aaa37e6ebc6
user:      jruoho <jruoho%NetBSD.org@localhost>
date:      Mon Aug 29 15:35:29 2011 +0000

description:
Some improvements.

diffstat:

 share/man/man4/dtvi2c.4 |  67 +++++++++++++++++++++++++++++++-----------------
 1 files changed, 43 insertions(+), 24 deletions(-)

diffs (124 lines):

diff -r f4553c701750 -r 9aaa37e6ebc6 share/man/man4/dtvi2c.4
--- a/share/man/man4/dtvi2c.4   Mon Aug 29 15:14:04 2011 +0000
+++ b/share/man/man4/dtvi2c.4   Mon Aug 29 15:35:29 2011 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: dtvi2c.4,v 1.2 2011/08/29 13:42:53 wiz Exp $
+.\" $NetBSD: dtvi2c.4,v 1.3 2011/08/29 15:35:29 jruoho Exp $
 .\"
 .\" Copyright (c) 2011 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -27,20 +27,25 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd August 14, 2011
+.Dd August 29, 2011
 .Dt DTVI2C 4
 .Os
 .Sh NAME
 .Nm dtvi2c
-.Nd iic-connected support modules for dtv
+.Nd Inter IC (I2C) modules for
+.Ic dtv
 .Sh DESCRIPTION
 The
 .Nm
-modules are drivers for support hardware needed by DVB devices.
-This includes e.g. tuners, demodulators, and analog video decoders.
+modules provide support for
+.Xr dtv 4
+devices.
+The
+.Nm
+group includes digital tuners, demodulators, and analog video decoders.
 .Pp
 The usual hardware structure consists of a host controller
-(connected via
+(connected for instance via
 .Xr usb 4
 or
 .Xr pci 4 )
@@ -52,37 +57,52 @@
 For example, a typical
 .Xr dtv 4
 setup would look like this:
-.Bl -bullet -offset indent
+.Bl -enum -offset indent
 .It
-initialize transport stream (TS) port on host controller
+Initialize transport stream
+.Pq Dv TS
+port on the host controller.
 .It
-configure demodulator (put it in the ATSC/QAM/DVB-T/etc. mode)
+Configure the demodulator that
+.Dq demodulates
+the information from an intermediate frequency
+.Pq Dv IF
+that is provided to it by the associated tuner.
+This step typically includes setting the desired
+quadrature amplitude modulation
+.Pq Dv QAM
+and bandwidth, among other things.
 .It
-configure tuner (set frequency etc.)
+Configure the tuner.
+Typically this step includes at least setting the frequency.
 .It
-start TS transfer (using DMA transfers or USB high speed transfers)
+Start TS transfer (using
+.Dv DMA
+transfers or
+.Dv USB
+high speed transfers).
 .El
 .Pp
 The currently supported modules are:
 .Bl -tag -width 10n -offset indent
-.It au8522
+.It Ic au8522
 Auvitek AU8522 ATSC/QAM64/QAM256 demodulator
-.It cx24227
+.It Ic cx24227
 Conexant CX24227 ATSC/QAM64/QAM256 demodulator
-.It lg3303
+.It Ic lg3303
 LG LGDT3303 ATSC/QAM64/QAM256 demodulator
-.It mt2131
+.It Ic mt2131
 MicroTune MT2131 ATSC demodulator
-.It nxt2k
+.It Ic nxt2k
 XXX description
-.It tvpll
+.It Ic tvpll
 Generic PLL-based tuners
-.It xc3028
+.It Ic xc3028
 XCeive XC3028 analog and digital tuner
-.It xc5k
+.It Ic xc5k
 Xceive XC5000 analog and digital tuner
-.It zl10353
-Zarlink ZL10353 (Intel CE623x) DVB demodulator
+.It Ic zl10353
+Zarlink ZL10353 (Intel CE623x) demodulator
 .El
 .Sh FILES
 .Bl -bullet
@@ -107,7 +127,7 @@
 .Sh HISTORY
 The
 .Nm
-device driver first appeared in
+modules first appeared in
 .Nx 6.0 .
 .Sh AUTHORS
 .An -nosplit
@@ -120,5 +140,4 @@
 .Aq jakllsch%NetBSD.org@localhost ,
 and
 .An Jukka Ruohonen
-.Aq jruoho%netbsd.org@localhost .
-.Aq jakllsch%NetBSD.org@localhost ,
+.Aq jruohonen%iki.fi@localhost .