eMule Part File Plugin v0.3.7 for VideoLAN Client v0.8.6b
---------------------------------------------------------
The plugin can be built using Cygwin under Windows by following the same build 
instructions as for the VideoLAN Client itself:

- You need to have Cygwin installed with the packages necessary for building VLC.
  Refer to VLC's "How to compile on Windows using Cygwin" wiki for details:
  http://wiki.videolan.org/Win32CompileCygwin

- Download the sources for VLC 0.8.6b:
  http://download.videolan.org/pub/videolan/vlc/0.8.6b/vlc-0.8.6b.tar.bz2
  
- Download the pre-compiled additional libraries for VLC:
  ftp://ftp.videolan.org/pub/videolan/testing/win32/contrib-20070412-win32-bin-gcc-3.4.5-only.tar.bz2
  
- Extract the VLC source code to your Cygwin home directory
  ( for example: /home/username/vlc-0.8.6b )

- Extract the pre-compiled library package to your Cygwin root directory
  (the libraries and their include files will be placed in /usr/win32)

      tar xjvf contrib-20070412-win32-bin-gcc-3.4.5-only.tar.bz2 -C /

- Copy the included plugin source and related files from the /src directory to 
  the VLC source tree. Pay attention to the directory structure! When finished, 
  you should have:

      /home/username/config_vlc
      /home/username/vlc-0.8.6b/configure.ac (Overwrite the original)
      /home/username/vlc-0.8.6b/modules/access/partfile.c
      /home/username/vlc-0.8.6b/modules/access/Modules.am (Overwrite the original)

- From your home directory in Cygwin, chdir to the vlc-0.8.6b directory,
  and run the configuration script:

      prompt>  cd vlc-0.8.6b
      prompt>  ../config_vlc            <-- This will take a while to complete...

- At this point, you could run "make" to build the whole VLC media player, 
  together with the part file plugin. But since we only want the plugin, we'll 
  take a shortcut. Run the "toolbox" script as follows in order to generate some 
  necessary include files:

      prompt>  ./toolbox --update-includes

- The official binary release of VLC 0.8.6b uses the libvlc.dll shared 
  library. In order to compile the part file plugin, this library is 
  required to be present in /home/username/vlc-0.8.6b/src. Since we will 
  not build the whole package, you have to copy libvlc.dll from the 
  binary distributiom of VLC 0.8.6b into /home/username/vlc-0.8.6b/src.

- Go into ./modules/access and run "make" to build the plugin:

      prompt>  cd modules/access
      prompt>  make libaccess_partfile_plugin.dll

- Use the strip utility to remove debug symbols, etc. from the DLL file:

      prompt>  strip libaccess_partfile_plugin.dll

- Copy libaccess_partfile_plugin.dll to your VLC plugins directory
  and you are ready to go!!

--------------------------------------------------------
 by Cybermutant - Apr 24, 2007
