Date: Fri, 11 Oct 2013 12:18:18 +0000 (UTC) From: Dru Lavigne <dru@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r42937 - head/en_US.ISO8859-1/books/handbook/multimedia Message-ID: <201310111218.r9BCIIqt037098@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
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>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201310111218.r9BCIIqt037098>