From josef@daemon.li  Tue Dec 30 16:52:32 2003
Return-Path: <josef@daemon.li>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id AACCB16A4CE
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 30 Dec 2003 16:52:32 -0800 (PST)
Received: from taro.utanet.at (taro.utanet.at [213.90.36.45])
	by mx1.FreeBSD.org (Postfix) with ESMTP id ABA2443D31
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 30 Dec 2003 16:52:30 -0800 (PST)
	(envelope-from josef@daemon.li)
Received: from paris.utanet.at ([213.90.36.7])
	by taro.utanet.at with esmtp (Exim 4.12)
	id 1AbUb7-0002zN-00
	for FreeBSD-gnats-submit@freebsd.org; Wed, 31 Dec 2003 01:52:29 +0100
Received: from dsl-31-149.utaonline.at ([81.189.31.149] helo=jenny.daemon.li)
	by paris.utanet.at with esmtp (Exim 4.12)
	id 1AbUb3-0007WA-00
	for FreeBSD-gnats-submit@freebsd.org; Wed, 31 Dec 2003 01:52:25 +0100
Received: by jenny.daemon.li (Postfix, from userid 1005)
	id C24B96D0; Wed, 31 Dec 2003 01:54:25 +0100 (CET)
Message-Id: <20031231005425.C24B96D0@jenny.daemon.li>
Date: Wed, 31 Dec 2003 01:54:25 +0100 (CET)
From: Josef El-Rayes <josef@daemon.li>
Reply-To: Josef El-Rayes <josef@daemon.li>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [patch] handbook/multimedia: add chapter about tv cards
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         60749
>Category:       docs
>Synopsis:       [patch] handbook/multimedia: add chapter about tv cards
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    blackend
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          update
>Submitter-Id:   current-users
>Arrival-Date:   Tue Dec 30 17:00:36 PST 2003
>Closed-Date:    Fri Jan 02 14:05:31 PST 2004
>Last-Modified:  Fri Jan 02 14:05:31 PST 2004
>Originator:     Josef El-Rayes
>Release:        FreeBSD 4.9-STABLE i386
>Organization:
>Environment:
System: FreeBSD jenny.daemon.li 4.9-STABLE FreeBSD 4.9-STABLE #5: Sun Nov 16 23:10:01 CET 2003 josef@jenny.daemon.li:/usr/obj/usr/src/sys/JENNY i386


	
>Description:
  this patch adds a chapter about tv cards. based on bktr manpage
  and bktr_card.h.
	
>How-To-Repeat:
	
>Fix:

	

--- chapter.sgml.diff begins here ---
--- chapter.sgml.orig	Wed Dec 31 01:45:11 2003
+++ chapter.sgml	Wed Dec 31 01:51:35 2003
@@ -1442,6 +1442,97 @@
     </itemizedlist>
 
   </sect2>
+ </sect1> 
+
+ <sect1 id="tvcard">
+   <sect1info>
+     <authorgroup>
+       <author>
+         <firstname>Josef</firstname>
+         <surname>El-Rayes</surname>
+         <contrib>Contributed by</contrib>
+         <!-- 30 December 2003 -->
+       </author>
+     </authorgroup>
+   </sect1info>
+
+   <title>Setup and Use of TV Cards</title>
+
+    <sect2 id="tvcard-setup">
+      <title>Set up the driver</title>
+      <para>Most pci-based tv cards come with a Brooktree Bt848/849/878/879
+	Video Capture Chip, which is supported by the &man.bktr.4; driver.
+	FM tuner chips are also supported.  To have your kernel support
+	your card just add the &man.bktr.4; driver to your kernel
+	configuration:</para>
+
+      <programlisting>
+	device        bktr
+	device        iicbus
+	device        iicbb
+	device        smbus
+      </programlisting>
+
+      <para>These additional device drivers are necessary because of the
+	components being interconnected via an I2C bus.  Additionally, you
+	should add an entry whether you are going to use PAL or NTSC, to
+	avoid possible problems with your card.</para>
+
+      <programlisting>
+	options        BROOKTREE_SYSTEM_DEFAULT=BROOKTREE_PAL
+	options        BROOKTREE_SYSTEM_DEFAULT=BROOKTREE_NTSC
+      </programlisting>
+
+      <para>On booting, the driver tries to detect your card automatically.
+	If this fails, you can set your card manually in your kernel
+	configuration file:</para>
+      
+      <programlisting>
+	options BKTR_OVERRIDE CARD=1
+      </programlisting>
+
+      <para>or by using &man.sysctl.8;:</para>
+
+      <screen>&prompt.root; <userinput>sysctl -w hw.bt848.card=1</userinput></screen>
+
+      <para>See the manpage for details on what type to set.</para>
+    </sect2>
+
+    <sect2 id="tvcard-use">
+      <title>Useful applications</title>
+      <para>To actually enjoy your tv card you need to install one of the
+	following applications:</para>
+
+      <itemizedlist>
+	<listitem>
+	  <para><filename role="package">multimedia/fxtv</filename>
+	    provides TV-in-a-window and image/audio/video capture
+	    capabilities.</para>
+	</listitem>
+	<listitem>
+	  <para><filename role="package">multimedia/xawtv</filename>
+	    is also a TV application, with the same features as
+	    fxtv.</para>
+	</listitem>
+	<listitem>
+	  <para><filename role="package">multimedia/nxtvepg</filename>,
+	    a Decoder, Browser and Analyzer for the Nextview Electronic
+	    Programme Guide.</para>
+	</listitem>
+	<listitem>
+	  <para><filename role="package">misc/alevt</filename>decodes
+	    and displays Videotext/Teletext.</para>
+	</listitem>
+	<listitem>
+	  <para><filename role="package">audio/xmradio</filename>, a FM
+	    Radio Tuner for cards that come with a FM Radio tuner.</para>
+	</listitem>
+	<listitem>
+	  <para><filename role="package">audio/wmtune</filename>, a handy
+	    dockapp for radio tuners.</para>
+	</listitem>
+     </itemizedlist>
+    </sect2>
  </sect1>
 </chapter>
 
--- chapter.sgml.diff ends here ---


>Release-Note:
>Audit-Trail:

From: Szilveszter Adam <sziszi@bsd.hu>
To: freebsd-gnats-submit@freebsd.org
Cc:  
Subject: Re: docs/60749: [patch] handbook/multimedia: add chapter about tv cards
Date: Wed, 31 Dec 2003 07:58:03 +0100

 On Wed, Dec 31, 2003 at 01:54:25AM +0100, Josef El-Rayes wrote:
 > +   <title>Setup and Use of TV Cards</title>
 > +
 > +    <sect2 id="tvcard-setup">
 > +      <title>Set up the driver</title>
 > +      <para>Most pci-based tv cards come with a Brooktree Bt848/849/878/879
 > +	Video Capture Chip, which is supported by the &man.bktr.4; driver.
 > +	FM tuner chips are also supported.  To have your kernel support
 > +	your card just add the &man.bktr.4; driver to your kernel
 > +	configuration:</para>
 
 Hm I am not sure about this part... at least in my part of the world,
 (Central Europe) it is becoming harder to find a Brooktree based TV
 card, revent models use a Philips chipset which has better picture
 quality but is AFAIK not supported by FreeBSD... so you have to be extra
 careful when buying.
 
 Just my HUF 0.02...
 -- 
 Regards:
 
 Szilveszter ADAM
 Budapest
 Hungary
Responsible-Changed-From-To: freebsd-doc->blackend 
Responsible-Changed-By: blackend 
Responsible-Changed-When: Wed Dec 31 02:51:23 PST 2003 
Responsible-Changed-Why:  
I'll handle this one. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=60749 
State-Changed-From-To: open->closed 
State-Changed-By: blackend 
State-Changed-When: Fri Jan 2 14:02:50 PST 2004 
State-Changed-Why:  
I committed a very different version of your patch.  Your submission 
was too much based on the bktr(4) manual page, however you are in the 
section credits. 
For more informations about the changes I made, please look at the 
committed diff.  Thanks! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=60749 
>Unformatted:
