grammar/wording/markup fixes

git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@19592 b3059339-0415-0410-9bf9-f77b7e298cf2

1 files changed, 27 insertions, 19 deletions

diff --git a/DOCS/xml/en/radio.xml b/DOCS/xml/en/radio.xml
index 8a1e89bb35..acad76ace0 100644
--- a/DOCS/xml/en/radio.xml
+++ b/DOCS/xml/en/radio.xml
@@ -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 @@ of Radio options and keyboard controls.
 <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 @@ of Radio options and keyboard controls.
 <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 @@ Here are just a few tips:
 <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 @@ channel's name. Spaces in the channel name must be replaced by the
 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 @@ use <option>-ao pcm:file=file.wav</option>. In second case you will not hear any
 
 <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 @@ mplayer radio://104.4<!--
 
 <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 @@ mplayer -radio channels=104.4=Sibir,103.9=Maximm  radio://2<!--
 
 <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>