[media] doc-rst: add documentation for saa7134

Convert it to ReST and add to the media/v4l-device book.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>

diff --git a/Documentation/media/v4l-drivers/index.rst b/Documentation/media/v4l-drivers/index.rst
index 03d07f25c5fbfdeee62f3cf81a8504c357a91f5f..f761627d3fa12ad44fa94908b3c07ada6d9bb791 100644 (file)
--- a/Documentation/media/v4l-drivers/index.rst
+++ b/Documentation/media/v4l-drivers/index.rst
@@ -33,4 +33,5 @@ License".
        pvrusb2
        pxa_camera
        radiotrack
+       saa7134
        zr364xx

diff --git a/Documentation/media/v4l-drivers/saa7134.rst b/Documentation/media/v4l-drivers/saa7134.rst
index b911f08718744a43a4f553886f03596a037718b1..584caf8a3594a75c0a3cd176107ead4373142427 100644 (file)
--- a/Documentation/media/v4l-drivers/saa7134.rst
+++ b/Documentation/media/v4l-drivers/saa7134.rst
@@ -1,7 +1,8 @@
+The saa7134 driver
+==================
 
+Author Gerd Hoffmann
 
-What is it?
-===========
 
 This is a v4l2/oss device driver for saa7130/33/34/35 based capture / TV
 boards.  See http://www.semiconductors.philips.com/pip/saa7134hl for a
@@ -9,7 +10,7 @@ description.
 
 
 Status
-======
+------
 
 Almost everything is working.  video, sound, tuner, radio, mpeg ts, ...
 
@@ -19,12 +20,14 @@ configuration info.
 
 
 Build
-=====
+-----
 
 Pick up videodev + v4l2 patches from http://bytesex.org/patches/.
 Configure, build, install + boot the new kernel.  You'll need at least
 these config options:
 
+.. code-block:: none
+
        CONFIG_I2C=m
        CONFIG_VIDEO_DEV=m
 
@@ -35,7 +38,7 @@ valid choices.
 
 
 Changes / Fixes
-===============
+---------------
 
 Please mail me unified diffs ("diff -u") with your changes, and don't
 forget to tell me what it changes / which problem it fixes / whatever
@@ -43,40 +46,32 @@ it is good for ...
 
 
 Known Problems
-==============
+--------------
 
 * The tuner for the flyvideos isn't detected automatically and the
   default might not work for you depending on which version you have.
   There is a tuner= insmod option to override the driver's default.
 
 Card Variations:
-================
+----------------
 
 Cards can use either of these two crystals (xtal):
- - 32.11 MHz -> .audio_clock=0x187de7
- - 24.576MHz -> .audio_clock=0x200000
-(xtal * .audio_clock = 51539600)
+
+- 32.11 MHz -> .audio_clock=0x187de7
+- 24.576MHz -> .audio_clock=0x200000 (xtal * .audio_clock = 51539600)
 
 Some details about 30/34/35:
 
- - saa7130 - low-price chip, doesn't have mute, that is why all those
- cards should have .mute field defined in their tuner structure.
+- saa7130 - low-price chip, doesn't have mute, that is why all those
+  cards should have .mute field defined in their tuner structure.
 
- - saa7134 - usual chip
+- saa7134 - usual chip
 
- - saa7133/35 - saa7135 is probably a marketing decision, since all those
- chips identifies itself as 33 on pci.
+- saa7133/35 - saa7135 is probably a marketing decision, since all those
+  chips identifies itself as 33 on pci.
 
 Credits
-=======
+-------
 
 andrew.stevens@philips.com + werner.leeb@philips.com for providing
 saa7134 hardware specs and sample board.
-
-
-Have fun,
-
-  Gerd
-
---
-Gerd Knorr <kraxel@bytesex.org> [SuSE Labs]