changeset 19586:16e32d49b61d

grammar/wording/markup fixes

--- a/DOCS/xml/en/radio.xml	Tue Aug 29 14:19:20 2006 +0000
+++ b/DOCS/xml/en/radio.xml	Tue Aug 29 16:36:45 2006 +0000
@@ -7,9 +7,9 @@
 <title>Radio input</title>
 
 <para>
-This section is about how to enable <emphasis role="bold">listening
-from V4L compatible Radio tuner</emphasis>. See the man page for a description
-of Radio options and keyboard controls.
+This section is about how to enable listening to radio from
+a V4L-compatible radio tuner. See the man page for a
+description of radio options and keyboard controls.
 </para>
 
 
@@ -19,7 +19,8 @@
 <procedure>
 <step><para>
   First, you have to recompile MPlayer using <filename>./configure</filename> with
-  --enable-radio and (if you want capture support) --enable-radio-capture.
+  <option>--enable-radio</option> and (if you want capture support)
+  <option>--enable-radio-capture</option>.
   </para></step>
 <step><para>
   Make sure your tuner works with another radio software in Linux, for
@@ -31,7 +32,7 @@
 <sect2 id="radio-tips">
 <title>Usage tips</title>
 <para>
-The full listing of the options is available on the manual page.
+The full listing of the options is available in the manual page.
 Here are just a few tips:
 </para>
 <itemizedlist>
@@ -39,10 +40,10 @@
 <para>
 Use the <option>channels</option> option. An example:
 <screen>-radio channels=104.4-Sibir,103.9-Maximum</screen>
-Explanation: using this option, only the 104.4 and 103.9 radio stations
-will be usable, and there will be a nice OSD text upon channel switching, displaying the
-channel's name. Spaces in the channel name must be replaced by the
-&quot;_&quot; character.
+Explanation: With this option, only the 104.4 and 103.9 radio stations
+will be usable. There will be a nice OSD text upon channel switching,
+displaying the channel's name. Spaces in the channel name must be
+replaced by the &quot;_&quot; character.
 </para>
 </listitem>
 
@@ -51,17 +52,19 @@
 There are several ways of capturing audio. You can grab the sound either using
 your sound card via an external cable connection between video card and line-in,
 or using the built-in ADC in the saa7134 chip. In the latter case, you have to
-load the <emphasis role="bold">saa7134-alsa</emphasis> or 
-<emphasis role="bold">saa7134-oss</emphasis> driver. 
+load the <systemitem>saa7134-alsa</systemitem> or
+<systemitem>saa7134-oss</systemitem> driver.
 </para>
 </listitem>
 
 <listitem>
 <para>
 <application>MEncoder</application> cannot be used for audio capture, because it
-requires video stream to work. So your can either use arecord from ALSA project or 
-use <option>-ao pcm:file=file.wav</option>. In second case you will not hear any sound
-(except you using line-in cable and have switched line-in mute off)
+requires a video stream to work. So your can either use
+<application>arecord</application> from ALSA project or
+use <option>-ao pcm:file=file.wav</option>. In the latter case you
+will not hear any sound (unless you are using a line-in cable and
+have switched line-in mute off).
 </para>
 </listitem>
 </itemizedlist>
@@ -74,7 +77,7 @@
 
 <informalexample>
 <para>
-Input from standard V4L (using line-in cable. capture switched off):
+Input from standard V4L (using line-in cable, capture switched off):
 <screen>
 mplayer radio://104.4<!--
 --></screen>
@@ -83,7 +86,8 @@
 
 <informalexample>
 <para>
-Input from standard V4L (using line-in cable. capture switched off, V4Lv1 interface):
+Input from standard V4L (using line-in cable, capture switched off,
+V4Lv1 interface):
 <screen>
 mplayer -radio driver=v4l radio://104.4<!--
 --></screen>
@@ -101,12 +105,16 @@
 
 <informalexample>
 <para>
-Using sound through pci bus from radio card's internal ADC. In this example tuner used as second sound card 
-(ALSA device hw:1,0). For saa7134 based cards either saa7134-alsa or saa7134-oss module must be 
-loaded . NOTE: when using ALSA device names colons must be replaced with equals, commas with dots. 
+Passing sound over the PCI bus from the radio card's internal ADC.
+In this example the tuner is used as a second sound card
+(ALSA device hw:1,0). For saa7134-based cards either the
+saa7134-alsa or saa7134-oss module must be loaded.
+<note><para>When using ALSA device names colons must be replaced
+by equal signs, commas by periods.
 <screen>
 mplayer -rawaudio rate=32000 -radio adevice=hw=1.0:arate=32000:channels=104.4=Sibir,103.9=Maximm  radio://2/capture<!--
 --></screen>
+</para></note>
 </para>
 </informalexample>
 </sect2>