changeset 32872:e91f07a9d5cd

Improve skin documentation.

--- a/DOCS/xml/de/skin.xml	Thu Feb 24 11:41:05 2011 +0000
+++ b/DOCS/xml/de/skin.xml	Thu Feb 24 13:39:48 2011 +0000
@@ -77,17 +77,17 @@
         Zur Zeit sind vier Fenster zu dekorieren: das
         <link linkend="skin-file-main">Hauptfenster</link>, das
         <link linkend="skin-file-subwindow">Unterfenster</link>, die
-        <link linkend="skin-file-main">Abspielleitse</link> und das
-        <link linkend="skin-file-menu">Skin-Menü</link> (das durch einen
-        Rechtsklick aktiviert werden kann).
+        <link linkend="skin-file-main">Abspielleiste</link> und das
+        <link linkend="skin-file-menu">Skin-Menü</link>.
 
         <itemizedlist>
           <listitem>
             <para>
-              Das <emphasis role="bold">Hauptfenster</emphasis> und/oder die
-              <emphasis role="bold">Abspielleiste</emphasis> befindet sich dort, wo du
-              <application>MPlayer</application> kontrollieren kannst. Der Hintergrund
-              des Fensters ist eine Grafik.
+              Mit dem <emphasis role="bold">Hauptfenster</emphasis> kontrolliert
+              man den <application>MPlayer</application>.
+              Die <emphasis role="bold">Abspielleiste</emphasis> erscheint im
+              Vollbild-Modus, sobald man die Maus unten an den Bildschirm bewegt.
+              Der Hintergrund der Fenster ist eine Grafik.
               Ins Fenster können (und müssen) diverse Elemente platziert werden:
               <emphasis>Buttons</emphasis>, <emphasis>Potentiometer</emphasis> (Schieberegler)
               und <emphasis>Labels</emphasis>.
@@ -145,8 +145,9 @@
           <listitem>
             <para>
               Das <emphasis role="bold">Skin-Menü</emphasis> ist ganz einfach ein
-              Weg, <application>MPlayer</application> mittels der Menüeinträge zu
-              kontrollieren. Zwei Grafiken sind für das Menü erforderlich:
+              Weg, <application>MPlayer</application> mittels Menüeinträgen zu
+              kontrollieren. Es wird durch die mittlere Maustaste aktiviert.
+              Zwei Grafiken sind für das Menü erforderlich:
               eine davon ist die Basisgrafik, die den Normalzustand des Menüs darstellt,
               die andere wird zur Anzeige der gewählten Einträge verwendet.
               Wenn du das Menü aufklappst, wird die erste Grafik angezeigt. Bewegst du
@@ -259,14 +260,16 @@
       <itemizedlist>
         <listitem><para><emphasis role="bold">main</emphasis> - für das Hauptfenster</para></listitem>
         <listitem><para><emphasis role="bold">sub</emphasis> - für das Unterfenster</para></listitem>
+        <listitem><para><emphasis role="bold">playbar</emphasis> - für die Abspielleiste</para></listitem>
         <listitem><para><emphasis role="bold">menu</emphasis> - für das Skin-Menü</para></listitem>
-        <listitem><para><emphasis role="bold">playbar</emphasis> - Abspielleiste</para></listitem>
       </itemizedlist>
     </para>
 
     <para>
-      (Die sub- und menu-Blöcke sind optional - du musst kein Menü erzeugen oder
-      das Unterfenster dekorieren.)
+      (Die sub-, playbar- und menu-Blöcke sind optional - es ist nicht
+      nötig, das Unterfenster zu dekorieren, eine Abspielleiste zu haben
+      oder ein Menü zu erzeugen. Ein Standard-Menü steht immer über die
+      rechte Maustaste zur Verfügung.)
     </para>
 
     <para>

--- a/DOCS/xml/en/skin.xml	Thu Feb 24 11:41:05 2011 +0000
+++ b/DOCS/xml/en/skin.xml	Thu Feb 24 13:39:48 2011 +0000
@@ -22,15 +22,15 @@
 <link linkend="skin-file-main">main window</link>, the
 <link linkend="skin-file-subwindow">subwindow</link>, the
 <link linkend="skin-file-main">playbar</link>, and the
-<link linkend="skin-file-menu">skin menu</link> (which can be activated
-by a right click).
+<link linkend="skin-file-menu">skin menu</link>.
 
 <itemizedlist>
 <listitem>
   <para>
-  The <emphasis role="bold">main window</emphasis> and/or the
-  <emphasis role="bold">playbar</emphasis> is where you can control
-  <application>MPlayer</application>. The background of the window is an image.
+  The <emphasis role="bold">main window</emphasis> is where you can control
+  <application>MPlayer</application>. The <emphasis role="bold">playbar</emphasis>
+  shows up in fullscreen mode when moving the mouse to the bottom of
+  the screen. The background of the windows is an image.
   Various items can (and must) be placed in the window:
   <emphasis>buttons</emphasis>, <emphasis>potmeters</emphasis> (sliders) and
   <emphasis>labels</emphasis>.
@@ -82,7 +82,8 @@
 <listitem>
   <para>
   The <emphasis role="bold">skin menu</emphasis> is just a way to control
-  <application>MPlayer</application> by means of menu entries. Two images
+  <application>MPlayer</application> by means of menu entries (which can be
+  activated by a middle mouse button click). Two images
   are required for the menu: one of them is the base image that shows the
   menu in its normal state, the other one is used to display the selected
   entries. When you pop up the menu, the first image is shown. If you move
@@ -206,17 +207,18 @@
   <emphasis role="bold">sub</emphasis> - for the subwindow
 </para></listitem>
 <listitem><para>
-  <emphasis role="bold">menu</emphasis> - for the skin menu
+  <emphasis role="bold">playbar</emphasis> - for the playbar
 </para></listitem>
 <listitem><para>
-  <emphasis role="bold">playbar</emphasis> - playbar
+  <emphasis role="bold">menu</emphasis> - for the skin menu
 </para></listitem>
 </itemizedlist>
 </para>
 
 <para>
-(The sub and menu blocks are optional - you do not need to create a menu or
-decorate the subwindow.)
+(The sub, playbar and menu blocks are optional - you do not need to decorate
+the subwindow, have a playbar or create a menu. A default menu is always
+available by a right mouse button click.)
 </para>
 
 <para>