This patch does the following:

- correctly comments author info
- renames 8.5 to TV Cards and removes Introduction header
- minor word-smithing
- fixes acronym tags

Approved by:	bcr (mentor)

en_US.ISO8859-1/books/handbook/multimedia/chapter.xml

@@ -6,6 +6,7 @@
 -->
 
 <chapter id="multimedia">
+  <!--
   <chapterinfo>
     <authorgroup>
       <author>
@@ -15,6 +16,7 @@
       </author>
     </authorgroup>
   </chapterinfo>
+  -->
 
   <title>Multimedia</title>
 
@@ -1297,6 +1299,7 @@ zoom=yes</programlisting>
 </sect1>
 
 <sect1 id="tvcard">
+  <!--
   <sect1info>
     <authorgroup>
       <author>
@@ -1309,31 +1312,28 @@ zoom=yes</programlisting>
       <author>
 	<firstname>Marc</firstname>
 	<surname>Fonvieille</surname>
-	<contrib>Enhanced and adapted by </contrib>
+	<contrib>Enhanced and adapted by in January 2004</contrib>
-	<!-- 02 January 2004 -->
       </author>
     </authorgroup>
   </sect1info>
+  -->
 
-  <title>Setting Up TV Cards</title>
+  <title>TV Cards</title>
 
   <indexterm>
     <primary>TV cards</primary>
   </indexterm>
 
-  <sect2>
+    <para>TV cards can be used to watch broadcast or cable TV on
-    <title>Introduction</title>
+      a computer.  Most cards accept composite video via an <acronym>RCA</acronym> or
-
+      S-video input and some cards include a <acronym>FM</acronym> radio tuner.</para>
-    <para>TV cards allow can be used to watch broadcast or cable TV on
-      a computer.  Most cards accept composite video via an RCA or
-      S-video input and some cards include a FM radio tuner.</para>
 
     <para>&os; provides support for PCI-based TV cards using a
-      Brooktree Bt848/849/878/879 or a Conexant CN-878/Fusion 878a
+      Brooktree Bt848/849/878/879
-      video capture chip with the &man.bktr.4; driver.  Ensure the
+      video capture chip with the &man.bktr.4; driver.  This driver
-      board comes with a supported tuner.  Consult &man.bktr.4; for a
+      supports most Pinnacle PCTV video cards.  Before purchasing a TV card,
+      onsult &man.bktr.4; for a
       list of supported tuners.</para>
-  </sect2>
 
   <sect2>
     <title>Loading the Driver</title>
@@ -1358,7 +1358,7 @@ device	smbus</programlisting>
 	components are interconnected via an I2C bus.  Then, build and
 	install a new kernel.</para>
 
-      <para>To test the driver, reboot the system.  The TV card
+      <para>To test that the tuner is correctly detected, reboot the system.  The TV card
 	should appear in the boot messages, as seen in this
 	example:</para>
 
@@ -1369,11 +1369,10 @@ iicbus1: &lt;Philips I2C bus&gt; on iicbb0 master-only
 smbus0: &lt;System Management Bus&gt; on bti2c0
 bktr0: Pinnacle/Miro TV, Philips SECAM tuner.</programlisting>
 
-      <para>The messages will differ according to the hardware.  Check
+      <para>The messages will differ according to the hardware.
-	the messages to determine if the tuner is correctly detected.
+	If necessary, it is possible to override some of the detected
-	It is still possible to override some of the detected
+	parameters using &man.sysctl.8; or custom kernel configuration
-	parameters with &man.sysctl.8; MIBs and kernel configuration
+	options.  For example, to force the tuner to a Philips
-	file options.  For example, to force the tuner to a Philips
 	SECAM tuner, add the following line to a custom kernel
 	configuration file:</para>
 
@@ -1383,9 +1382,8 @@ bktr0: Pinnacle/Miro TV, Philips SECAM tuner.</programlisting>
 
       <screen>&prompt.root; <userinput>sysctl hw.bt848.tuner=6</userinput></screen>
 
-      <para>Refer to &man.bktr.4; and
+      <para>Refer to &man.bktr.4; for a description
-	<filename>/usr/src/sys/conf/NOTES</filename> for more
+	of the available &man.sysctl.8; parameters and kernel options.</para>
-	details on the available options.</para>
     </sect2>
 
     <sect2>
@@ -1421,8 +1419,8 @@ bktr0: Pinnacle/Miro TV, Philips SECAM tuner.</programlisting>
       <para>If any problems are encountered with the TV card,
 	check that the video capture chip and the tuner are
 	supported by &man.bktr.4; and that the right configuration
-	options were used.  For more support and various questions
+	options were used.  For more support or to ask questions
-	about TV cards, refer to the archives of the
+	about supported TV cards, refer to the
 	&a.multimedia.name; mailing list.</para>
     </sect2>
   </sect1>
@@ -1430,68 +1428,64 @@ bktr0: Pinnacle/Miro TV, Philips SECAM tuner.</programlisting>
   <sect1 id="mythtv">
     <title>MythTV</title>
 
-    <para>MythTV is a popular, open source <acronym
+    <para>MythTV is a popular, open source Personal Video Recorder
-	role="Personal Video Recorder">PVR</acronym>
+      (<acronym>PVR</acronym>)
       application.  This section demonstrates how to install and
-      setup MythTV on &os;.  Refer to the <ulink
+      setup MythTV on &os;.  Refer to <ulink
-	url="http://www.mythtv.org/wiki/">MythTV wiki</ulink> for
+	url="http://www.mythtv.org/wiki/">mythtv.org/wiki</ulink> for
       more information on how to use MythTV.</para>
 
-      <para>MythTV requires a frontend and a backend; however,
+      <para>MythTV requires a frontend and a backend.  These components
-	it allows the user to have the frontend and backend on
+	can either be installed on the same system or on
 	different machines.</para>
 
-      <para>For the frontend, <filename
+      <para>The frontend can be installed on &os; using the <filename
-	  role="package">multimedia/mythtv-frontend</filename> is
+	  role="package">multimedia/mythtv-frontend</filename> package or port.
-	required, as well as an X server, which can be found in
+	<application>&xorg;</application> must also be installed and configured as described in
-	<filename role="package">x11/xorg</filename>.  Ideally, the
+	<xref linkend="x11"/>.  Ideally, this
-	frontend computer also has a video card that supports <acronym
+	system has a video card that supports X-Video Motion Compensation
-	  role="X-Video Motion Compensation">XvMC</acronym> and,
+	(<acronym>XvMC</acronym>) and,
-	optionally, a <acronym role="Linux Infrared Remote
+	optionally, a Linux Infrared Remote Control
-	  Control">LIRC</acronym>-compatible remote.</para>
+	(<acronym>LIRC</acronym>)-compatible remote.</para>
 
-      <para>For the backend, <filename
+      <para>To install both the backend and the frontend on &os;, use the <filename
-	  role="package">multimedia/mythtv</filename> is required,
+	  role="package">multimedia/mythtv</filename> package or port.
-	along with the &mysql; database server.  Optionally a tuner
+	A &mysql; database server is also required and should
-	and storage for any recorded data.  The &mysql; package should
+	automatically be installed as a dependency.
-	be automatically installed as a dependency when installing
+	Optionally, this system should have a tuner card
-	<filename role="package">multimedia/mythtv</filename>.</para>
+	and sufficient storage to hold recorded data.</para>
 
     <sect2>
       <title>Hardware</title>
 
-      <para>MythTV is designed to utilize <acronym
+      <para>MythTV uses Video for Linux (<acronym>V4L</acronym>) to access video input
-	  role="Video for Linux">V4L</acronym> to access video input
+	devices such as encoders and tuners.  In &os;, MythTV
-	devices such as encoders and tuners.  At this time, MythTV
+	works best with <acronym>USB</acronym> DVB-S/C/T cards as they are well supported by the <filename
-	works best with <acronym role="Universal Serial
+	  role="package">multimedia/webcamd</filename> package or port which provides
-	  Bus">USB</acronym> DVB-S/C/T cards supported by <filename
+	a <acronym>V4L</acronym> userland application.
-	  role="package">multimedia/webcamd</filename>, as it provides
+	Any Digital Video Broadcasting (<acronym>DVB</acronym>)
-	a <acronym
-	  role="Video for Linux">V4L</acronym> userland application.
-	Any <acronym role="Digital Video Broadcasting">DVB</acronym>
 	card supported by <application>webcamd</application> should
 	work with MythTV.  A list of known working cards can be
-	found <ulink
+	found at <ulink
-	  url="http://wiki.freebsd.org/WebcamCompat">here</ulink>.
+	  url="http://wiki.freebsd.org/WebcamCompat">wiki.freebsd.org/WebcamCompat</ulink>.
 	Drivers are also available for Hauppauge cards in the
-	following ports: <filename
+	<filename
 	  role="package">multimedia/pvr250</filename> and <filename
-	  role="package">multimedia/pvrxxx</filename>, but they
+	  role="package">multimedia/pvrxxx</filename> ports, but they
 	provide a non-standard driver interface that does not work
 	with versions of MythTV greater than 0.23.  Due to licensing
 	restrictions, no packages are available and these two ports
 	must be compiled.</para>
 
-      <para>The <ulink url="http://wiki.freebsd.org/HTPC">HTPC
+      <para>The <ulink url="http://wiki.freebsd.org/HTPC">wiki.freebsd.org/HTPC</ulink>
-	  wiki page</ulink> contains a list of all available <acronym
+	page contains a list of all available <acronym>DVB</acronym>
-	  role="Digital Video Broadcasting">DVB</acronym>
 	drivers.</para>
     </sect2>
 
     <sect2>
-      <title>Setting up MythTV</title>
+      <title>Setting up the MythTV Backend</title>
 
-      <para>To install the MythTV port:</para>
+      <para>To install MythTV using the port:</para>
 
       <screen>&prompt.root; <userinput>cd /usr/ports/multimedia/mythtv</userinput>
 &prompt.root; <userinput>make install</userinput></screen>
@@ -1500,11 +1494,11 @@ bktr0: Pinnacle/Miro TV, Philips SECAM tuner.</programlisting>
 
       <screen>&prompt.root; <userinput>mysql -uroot -p &lt; /usr/local/share/mythtv/database/mc.sql</userinput></screen>
 
-      <para>Configure the backend:</para>
+      <para>Then, configure the backend:</para>
 
       <screen>&prompt.root; <userinput>mythtv-setup</userinput></screen>
 
-      <para>Start the backend:</para>
+      <para>Finally, start the backend:</para>
 
       <screen>&prompt.root; <userinput>echo 'mythbackend_enable="YES"' &gt;&gt; /etc/rc.conf</userinput>
 &prompt.root; <userinput>service mythbackend start</userinput></screen>
@@ -1512,16 +1506,17 @@ bktr0: Pinnacle/Miro TV, Philips SECAM tuner.</programlisting>
   </sect1>
 
   <sect1 id="scanners">
+    <!--
     <sect1info>
       <authorgroup>
 	<author>
 	  <firstname>Marc</firstname>
 	  <surname>Fonvieille</surname>
-	  <contrib>Written by </contrib>
+	  <contrib>Written by in August 2004</contrib>
-	  <!-- 04 August 2004 -->
 	</author>
       </authorgroup>
     </sect1info>
+    -->
 
     <title>Image Scanners</title>