new Windows section with Cygwin and MinGW subsections

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

1 files changed, 66 insertions, 21 deletions

diff --git a/DOCS/en/documentation.html b/DOCS/en/documentation.html
index 4d71fd8b7c..a6aa5b6f9a 100644
--- a/DOCS/en/documentation.html
+++ b/DOCS/en/documentation.html
@@ -282,7 +282,11 @@
       <LI><A HREF="#solaris">6.3 Solaris</A></LI>
       <LI><A HREF="#sgi">6.4 Silicon Graphics / Irix</A></LI>
       <LI><A HREF="#qnx">6.5 QNX</A></LI>
-      <LI><A HREF="#cygwin">6.6 Cygwin</A></LI>
+      <LI><A HREF="#windows">6.6 Windows</A></LI>
+        <UL>
+          <LI><A HREF="#cygwin">6.6.1 Cygwin</A></LI>
+          <LI><A HREF="#mingw">6.6.2 MinGW</A></LI>
+        </UL>
     </UL>
   </LI>
   <LI><A HREF="encoding.html">7. Encoding with MEncoder</A>
@@ -1813,29 +1817,48 @@ end
   QNX has only X <I>emulation</I> which is VERY slow. Use SDL.</P>
 
 
-<H2><A NAME="cygwin">6.6 Cygwin</A></H2>
+<H2><A NAME="windows">6.6 Windows</A></H2>
 
-<P>The Cygwin port is still in its infancy. Currently there is no support for
-  OpenGL. SDL is known to distort sound and image or crash on some systems.
-  <A HREF="../tech/patches.txt">Patches</A> are always welcome.
-  Best results are achieved with the native DirectX video output driver
-  (<CODE>-vo directx</CODE>) and the native Windows waveout audio driver
-  (<CODE>-ao win32</CODE>). You should also check out the
+<P>Yes, MPlayer runs on Windows under
+  <A HREF="http://www.cygwin.com/">Cygwin</A> and
+  <A HREF="http://www.mingw.org/">MinGW</A>.
+  It does not have a GUI yet, but the command line version is almost completely
+  functional. <A HREF="../tech/patches.txt">Patches</A> are always welcome.
+  You should check out the
   <A HREF="http://mplayerhq.hu/mailman/listinfo/mplayer-cygwin/">mplayer-cygwin</A>
   mailing list for help and latest information.</P>
 
-<P>Cygwin versions prior to 1.3.23 do not include <CODE>inttypes.h</CODE>. You
+<P>Best results are achieved with the native DirectX video output driver
+  (<CODE>-vo directx</CODE>) and the native Windows waveout audio driver
+  (<CODE>-ao win32</CODE>)  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 <CODE>-vo directx:ontop</CODE>. If the image is
+  distorted, try turning off hardware acceleration with
+  <CODE>-vo directx:noaccel</CODE>. Download
+  <A HREF="http://www.videolan.org/vlc/dx7headers.tgz">DirectX 7 header files</A>
+  to compile the DirectX video output driver.</P>
+
+<P>QuickTime and Real DLLs also work. Compile with <CODE>--enable-qtx</CODE>
+  and <CODE>--enable-real</CODE> and put the codecs into the
+  default Windows DLL location, <CODE>C:\WINNT\system32</CODE> or
+  <CODE>C:\Windows\system</CODE> depending on your Windows version.</P>
+
+<P>There are precompiled binary versions made by Sascha Sommer available for
+  download from
+  <A HREF="http://www.mplayerhq.hu/MPlayer/releases/win32-beta/">our homepage</A>.
+  Joey Parrish has been making
+  <A HREF="http://joey.nicewarrior.org/cygmp/">unofficial Windows packages</A>
+  complete with installer.</P>
+
+<H3><A NAME="cygwin">6.6.1 Cygwin</A></H3>
+
+<P>Cygwin versions prior to 1.5.0 do not include <CODE>inttypes.h</CODE>. You
   will have to copy or symlink <CODE>etc/cygwin_inttypes.h</CODE> from the
   MPlayer source directory to <CODE>/usr/include/inttypes.h</CODE> in order to
   make MPlayer compile.</P>
 
-<P>To get native DirectX video, download
-  <A HREF="http://www.videolan.org/vlc/dx7headers.tgz">DirectX 7 header files</A>,
-  extract them to <CODE>/usr/include/</CODE> or <CODE>/usr/local/include/</CODE>
-  and recompile. You will then be able to use the directx video out driver. You
-  can make the movie window stay on top with <CODE>-vo directx:ontop</CODE>. If
-  the image is distorted, try turning off hardware acceleration with
-  <CODE>-vo directx:noaccel</CODE>.</P>
+<P>DirectX header files need to be extracted to <CODE>/usr/include/</CODE> or
+  <CODE>/usr/local/include/</CODE>.</P>
 
 <P>Instructions and files for making SDL run under Cygwin can be found on the
   <A HREF="http://www.libsdl.org/extras/win32/cygwin/">libsdl site</A>.</P>
@@ -1853,14 +1876,36 @@ end
 
 <P><CODE>mplayer dvd://&lt;title&gt; -dvd-device '\\.\d:'</CODE></P>
 
-<P>QuickTime and Real DLLs also work. Compile with <CODE>--enable-qtx</CODE>
-  <CODE>--enable-real</CODE> and put the codecs into the
-  default Windows DLL location, <CODE>C:\WINNT\system32</CODE> or
-  <CODE>C:\Windows\system</CODE> depending on your Windows version.</P>
-
 <P>The Cygwin console is rather slow. Redirecting output or using the
   <CODE>-quiet</CODE> option has been reported to improve performance.</P>
 
+<H3><A NAME="mingw">6.6.2 MinGW</A></H3>
+
+<P>Installing a version of MinGW that could compile MPlayer used to be quite
+  tricky, but only consists of three simple steps now and should work out of
+  the box soon.</P>
+
+<OL>
+  <LI>Install MinGW 3.0.0 or later.</LI>
+  <LI>Install MSYS 1.0.9 or later and tell the MSYS postinstall that
+    MinGW is installed.</LI>
+  <LI>Replace <CODE>/mingw/include/sys/types.h</CODE> with this
+    <A HREF="http://www.mplayerhq.hu/MPlayer/releases/win32-beta/contrib/types.h"><CODE>types.h</CODE></A>.</LI>
+</OL>
+
+<P>Extract DirectX header files to <CODE>/mingw/include/</CODE>.</P>
+
+<P>VCDs and DVDs work almost like Cygwin (adjust for the drive letter of your
+  CD-ROM):</P>
+
+<P><CODE>mplayer d:/mpegav/avseq01.dat</CODE></P>
+
+<P><CODE>mplayer /d/MPEG2/AVSEQ01.MPG</CODE></P>
+
+<P><CODE>mplayer dvd://&lt;title&gt; -dvd-device /d/</CODE></P>
+
+
+
 
 
 <H1><A NAME="encoding">7.</A> <A HREF="encoding.html">Encoding with MEncoder</A></H1>