svn commit: r42937 - head/en_US.ISO8859-1/books/handbook/multimedia
Dru Lavigne
dru at FreeBSD.org
Fri Oct 11 12:18:19 UTC 2013
Author: dru
Date: Fri Oct 11 12:18:18 2013
New Revision: 42937
URL: http://svnweb.freebsd.org/changeset/doc/42937
Log:
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)
Modified:
head/en_US.ISO8859-1/books/handbook/multimedia/chapter.xml
Modified: head/en_US.ISO8859-1/books/handbook/multimedia/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/handbook/multimedia/chapter.xml Fri Oct 11 09:17:57 2013 (r42936)
+++ head/en_US.ISO8859-1/books/handbook/multimedia/chapter.xml Fri Oct 11 12:18:18 2013 (r42937)
@@ -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>
- <!-- 02 January 2004 -->
+ <contrib>Enhanced and adapted by in January 2004</contrib>
</author>
</authorgroup>
</sect1info>
+ -->
- <title>Setting Up TV Cards</title>
+ <title>TV Cards</title>
<indexterm>
<primary>TV cards</primary>
</indexterm>
- <sect2>
- <title>Introduction</title>
-
- <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>TV cards can be used to watch broadcast or cable TV on
+ 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>&os; provides support for PCI-based TV cards using a
- Brooktree Bt848/849/878/879 or a Conexant CN-878/Fusion 878a
- video capture chip with the &man.bktr.4; driver. Ensure the
- board comes with a supported tuner. Consult &man.bktr.4; for a
+ Brooktree Bt848/849/878/879
+ video capture chip with the &man.bktr.4; driver. This driver
+ 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: <Philips I2C bus> on iicb
smbus0: <System Management Bus> on bti2c0
bktr0: Pinnacle/Miro TV, Philips SECAM tuner.</programlisting>
- <para>The messages will differ according to the hardware. Check
- the messages to determine if the tuner is correctly detected.
- It is still possible to override some of the detected
- parameters with &man.sysctl.8; MIBs and kernel configuration
- file options. For example, to force the tuner to a Philips
+ <para>The messages will differ according to the hardware.
+ If necessary, it is possible to override some of the detected
+ parameters using &man.sysctl.8; or custom kernel configuration
+ 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 t
<screen>&prompt.root; <userinput>sysctl hw.bt848.tuner=6</userinput></screen>
- <para>Refer to &man.bktr.4; and
- <filename>/usr/src/sys/conf/NOTES</filename> for more
- details on the available options.</para>
+ <para>Refer to &man.bktr.4; for a description
+ of the available &man.sysctl.8; parameters and kernel options.</para>
</sect2>
<sect2>
@@ -1421,8 +1419,8 @@ bktr0: Pinnacle/Miro TV, Philips SECAM t
<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
- about TV cards, refer to the archives of the
+ options were used. For more support or to ask questions
+ 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 t
<sect1 id="mythtv">
<title>MythTV</title>
- <para>MythTV is a popular, open source <acronym
- role="Personal Video Recorder">PVR</acronym>
+ <para>MythTV is a popular, open source Personal Video Recorder
+ (<acronym>PVR</acronym>)
application. This section demonstrates how to install and
- setup MythTV on &os;. Refer to the <ulink
- url="http://www.mythtv.org/wiki/">MythTV wiki</ulink> for
+ setup MythTV on &os;. Refer to <ulink
+ 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,
- it allows the user to have the frontend and backend on
+ <para>MythTV requires a frontend and a backend. These components
+ can either be installed on the same system or on
different machines.</para>
- <para>For the frontend, <filename
- role="package">multimedia/mythtv-frontend</filename> is
- required, as well as an X server, which can be found in
- <filename role="package">x11/xorg</filename>. Ideally, the
- frontend computer also has a video card that supports <acronym
- role="X-Video Motion Compensation">XvMC</acronym> and,
- optionally, a <acronym role="Linux Infrared Remote
- Control">LIRC</acronym>-compatible remote.</para>
-
- <para>For the backend, <filename
- role="package">multimedia/mythtv</filename> is required,
- along with the &mysql; database server. Optionally a tuner
- and storage for any recorded data. The &mysql; package should
- be automatically installed as a dependency when installing
- <filename role="package">multimedia/mythtv</filename>.</para>
+ <para>The frontend can be installed on &os; using the <filename
+ role="package">multimedia/mythtv-frontend</filename> package or port.
+ <application>&xorg;</application> must also be installed and configured as described in
+ <xref linkend="x11"/>. Ideally, this
+ system has a video card that supports X-Video Motion Compensation
+ (<acronym>XvMC</acronym>) and,
+ optionally, a Linux Infrared Remote Control
+ (<acronym>LIRC</acronym>)-compatible remote.</para>
+
+ <para>To install both the backend and the frontend on &os;, use the <filename
+ role="package">multimedia/mythtv</filename> package or port.
+ A &mysql; database server is also required and should
+ automatically be installed as a dependency.
+ Optionally, this system should have a tuner card
+ and sufficient storage to hold recorded data.</para>
<sect2>
<title>Hardware</title>
- <para>MythTV is designed to utilize <acronym
- role="Video for Linux">V4L</acronym> to access video input
- devices such as encoders and tuners. At this time, MythTV
- works best with <acronym role="Universal Serial
- Bus">USB</acronym> DVB-S/C/T cards supported by <filename
- role="package">multimedia/webcamd</filename>, as it provides
- a <acronym
- role="Video for Linux">V4L</acronym> userland application.
- Any <acronym role="Digital Video Broadcasting">DVB</acronym>
+ <para>MythTV uses Video for Linux (<acronym>V4L</acronym>) to access video input
+ devices such as encoders and tuners. In &os;, MythTV
+ works best with <acronym>USB</acronym> DVB-S/C/T cards as they are well supported by the <filename
+ role="package">multimedia/webcamd</filename> package or port which provides
+ a <acronym>V4L</acronym> userland application.
+ Any Digital Video Broadcasting (<acronym>DVB</acronym>)
card supported by <application>webcamd</application> should
work with MythTV. A list of known working cards can be
- found <ulink
- url="http://wiki.freebsd.org/WebcamCompat">here</ulink>.
+ found at <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
- wiki page</ulink> contains a list of all available <acronym
- role="Digital Video Broadcasting">DVB</acronym>
+ <para>The <ulink url="http://wiki.freebsd.org/HTPC">wiki.freebsd.org/HTPC</ulink>
+ page contains a list of all available <acronym>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 t
<screen>&prompt.root; <userinput>mysql -uroot -p < /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"' >> /etc/rc.conf</userinput>
&prompt.root; <userinput>service mythbackend start</userinput></screen>
@@ -1512,16 +1506,17 @@ bktr0: Pinnacle/Miro TV, Philips SECAM t
</sect1>
<sect1 id="scanners">
+ <!--
<sect1info>
<authorgroup>
<author>
<firstname>Marc</firstname>
<surname>Fonvieille</surname>
- <contrib>Written by </contrib>
- <!-- 04 August 2004 -->
+ <contrib>Written by in August 2004</contrib>
</author>
</authorgroup>
</sect1info>
+ -->
<title>Image Scanners</title>
More information about the svn-doc-all
mailing list