runtime 'stay-on-top' functionality

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

5 files changed, 22 insertions, 3 deletions

diff --git a/DOCS/man/en/mplayer.1 b/DOCS/man/en/mplayer.1
index 47700df114..befb7300db 100644
--- a/DOCS/man/en/mplayer.1
+++ b/DOCS/man/en/mplayer.1
@@ -278,6 +278,9 @@ decrease/\:increase volume
 mute sound
 .IPs f\ \ \ \ 
 toggle fullscreen
+.IPs T\ \ \ \ 
+toggle stay-on-top.
+Supported by drivers which use X11, except SDL, as well as directx and gl2 under Windows.
 .IPs "w and e"
 decrease/\:increase panscan range
 .IPs o\ \ \ \ 
@@ -1809,6 +1812,10 @@ window aspect hints.).
 .B \-noxv (SDL only)
 Disables XVideo SDL driver.
 .TP
+.B \-ontop 
+Makes the player window stay on top other windows.
+Supported by drivers which use X11, except SDL, as well as directx and gl2 under Windows.
+.TP
 .B \-panscan <0.0\-1.0>
 Enables Pan & Scan functionality, i.e.\& in order to display a 16:9 movie
 on a 4:3 display, the sides of the movie are cropped to get a 4:3 image
diff --git a/DOCS/tech/libvo.txt b/DOCS/tech/libvo.txt
index b1ee6811fa..e188b5853d 100644
--- a/DOCS/tech/libvo.txt
+++ b/DOCS/tech/libvo.txt
@@ -57,8 +57,12 @@ Each vo driver _has_ to implement these:
 	 VOCTRL_GET_EQUALIZER
 		get the current video equalizer values
 		two arguments are provided: item and value
-		item is a string, the possible values are (currenlty):
+		item is a string, the possible values are (currently):
 		    brightness, contrast, saturation, hue
+	 VOCTRL_ONTOP
+		Makes the player window stay-on-top. Only supported (currently)
+		by drivers which use X11, except SDL, as well as directx and
+		gl2 under Windows.
 
     config():	
       Set up the video system. You get the dimensions and flags.
diff --git a/DOCS/tech/slave.txt b/DOCS/tech/slave.txt
index 72165fc1f8..70a47084db 100644
--- a/DOCS/tech/slave.txt
+++ b/DOCS/tech/slave.txt
@@ -86,6 +86,10 @@ vo_fullscreen
 get_vo_fullscreen
     Print out fullscreen status (1 == fullscreened, 0 == windowed).
 
+vo_ontop
+	Toggle stay-on-top. Supported by drivers which use X11, except SDL,
+	as well as directx and gl2 under Windows.
+
 panscan <value> [value2]
     ???
 
diff --git a/DOCS/xml/en/ports.xml b/DOCS/xml/en/ports.xml
index 6b807dc3f4..37de7e3132 100644
--- a/DOCS/xml/en/ports.xml
+++ b/DOCS/xml/en/ports.xml
@@ -283,8 +283,7 @@ since QNX has only X <emphasis>emulation</emphasis> which is VERY slow. Use SDL.
 <para>Best results are achieved with the native DirectX video output driver
   (<option>-vo directx</option>) and the native Windows waveout audio driver
   (<option>-ao win32</option>)  as OpenGL does not work and SDL is known to
-  distort sound and image or crash on some systems. You can make the movie
-  window stay on top with <option>-vo directx:ontop</option>. If the image is
+  distort sound and image or crash on some systems. If the image is
   distorted, try turning off hardware acceleration with
   <option>-vo directx:noaccel</option>. Download
   <ulink url="http://www.videolan.org/vlc/dx7headers.tgz">DirectX 7 header files</ulink>
diff --git a/DOCS/xml/en/usage.xml b/DOCS/xml/en/usage.xml
index a0699a63c4..9a950fb660 100644
--- a/DOCS/xml/en/usage.xml
+++ b/DOCS/xml/en/usage.xml
@@ -295,6 +295,11 @@ You can have a full list of known commands by running
   <para>
   Switch fullscreen mode.
   </para></listitem>
+<listitem><para><literal>vo_ontop</literal></para>
+  <para>
+  Toggle stay-on-top. Supported by drivers which use X11, except SDL,
+  as well as directx and gl2 under Windows.
+  </para></listitem>
 <listitem><para><literal>tv_step_channel</literal> (int) dir</para>
   <para>
   Select next/previous tv channel.