                          VLC media player for OS/2
                         ---------------------------
                         
1. Introduce
------------

  This program is a port of VLC media player to OS/2.
  
2. Features...
--------------
  
  .Support Qt4 interface
  .Support DART/UNIAUD
  .Support SNAP/WarpOverlay!/DIVE
                             
3. Requirements...
------------------
  
  .kLIBC v0.6.3
  .Qt v4.6.3GA

4. How to launch
----------------

  1) Add '\vlc2\usr\local\lib' to LIBPATH in CONFIG.SYS
  
  2) Reboot
  
  3) Launch 'vlc.exe' on command line or on WPS

5. Limits or Known Bugs...
-------------------------
  
  .When using SDL vout driver, VLC exits abnormally after playing a movie 
   file.
   
6. TODOs...
-----------
  
  .Support all the plugins
  .Merge into the official source tree
  
7. History specific to OS/2...
------------------------------

  - vlc-1.1.11 ( 2011/08/07 )
    .Syn with VLC v1.1.11 sources
    
  - vlc-1.1.9 ( 2011/05/14 )
    .Sync with VLC v1.1.9 sources
    .Added mux_ts plugin( using libdvbpsi )
    .Added ts plugin( using libdvbpsi )
    .Added access_realrtsp plugin( Support rtsp:// )
    .Added live555 plugin( Support rtsp:// )
    .Added a plugin for Mozilla( NOT RECOMMENDED ) 

  - vlc-1.1.7 ( 2011/02/06 )
    .Sync with VLC v1.1.7 sources
    .kai: system hangs on when audio is played before video is initialized     
          with uniaud mode and snap mode pair 
    .kai: sounds are distorted on uniaud mode 

  - vlc-1.1.5 ( 2010/12/05 )
    .Sync with VLC v1.1.5 sources
    .core : NLS is not supported if VLC is installed on the other place than 
            /usr/local
            
  - vlc-1.1.4 ( 2010/11/20 )
    .Sync with VLC v1.1.4 sources
    .Added cdda plugin
    .Added vcd plugin
    .Added freetype plugin
    .Added lua plugin
    .Added xml plugin
    .kai : Support dart/uniaud mode selection
    .kai : Support shareable/exclusive mode selection
    .kva : Support embedded video mode Áö¿ø
    .kva : Support snap/wo/dive mode selection
    .kva : Support workaround for T23 
    .kva : Support Aspect Ratio, Crop
    .kai : SIGFPE occurs when playing AAC audio. Fixed
    .kva : Playing is not stopped even if closing a window on a stand-alone 
           window mode. Fixed
    .dvdnav : Play does not work. Fixed
    .Codepage should be specified into LANG env. var. Fixed 
     ( Use a current codepage )

  - vlc-1.0.5-beta1 ( 2010/05/30 )
    .Added KVA vout module
    .Files whose name is consisting of DBCS chars cannot be played. Fixed
    .'\' does not work in DBCS env. Fixed
    .--plugin-path is required. Fixed
    .Audio is not played. Fixed
    .DVD device is stored in wrong chars when specifying it. Fixed
    .SYS3171 occurs in LIBC063, When playing DVD. Fixed
    .SIGSEGV occurs when playing a music file using KAI aout driver. Fixed
    .VLC hangs on when trying to play a non-existent file if using Qt4 
     interface. Fixed (Use Qt 4.6.2GA)

  - vlc-1.0.5-tp2 ( 2010/04/11 )
    .Support libavcodec, libavformat, libswscale, libpostproc, liba52
    .Added KAI aout module
    .Convert '/' to '\' of 'HOME' env. var.
    .Assertion failed in input thread. Fixed
     ( call vlc_thread_join() before vlc_object_release() )

  - vlc-1.0.5-tp1 ( 2010/03/14 )
    .Technology Preview 1

8. How to compile
-----------------

8.1 Requirements
----------------

  Refer to the following site.
  
	http://wiki.videolan.org/Contrib_Status

8.2 Buld tools used for OS/2 port...
------------------------------------

  .GCC v4.4.5
  .binutils v2.21
  .GNU Make v3.81r3
  .wl(Open Watcom Linker) v1.6beta1
  .GNU utilities( cp, rm, mkdir, sed, find, ... )
  .pdksh v5.2.14-bin-2
  .autoconf v2.65
  .automake v1.11.1
  .pkg-config v0.23
  .libtool v2.2.6b-r3
  .OS/2 ToolKit v4.5
  .gettext v0.18.1.1
  
8.3 Libraries used for OS/2 port...
-----------------------------------

  .libvorbis v1.2.0
  .ligogg v1.1.3
  .flac v1.2.1 
  .x264 v0.110.1804
  .a52 v0.7.4
  .MPEG2DEC v0.5.1
  .faac v1.26
  .lame v3.98.4
  .FFmpeg SVN-r26402
  .libmad v0.15.1b
  .libdvdcss v1.2.10 
  .libdvdnav v4.1.4
  .libdvdread v4.1.4
  .libcddb v1.3.0
  .libcdio 0.81
  .libgpg-error v1.7
  .libgcrypt v1.4.5
  .libxml2 v2.7.8
  .libpng v1.2.31
  .SDL v1.2.10
  .freetype2 v2.3.11
  .fontconfig in mzfntcfgft 
  .zlib v1.2.3
  .Qt4 v4.6.3GA
  .lua v5.1.4
  .pthread on netlabs
  .libkva v1.1.2
  .libkai v1.1.1
  .libdvbpsi v0.2.0
  .live555 2011.03.14
    
8.4 Compilation
---------------

8.4.1 Applying patches
----------------------

  First of all, you should download the sources from VLC 
homepage(http://www.videolan.org/vlc/download-sources.html), and extract them 
into any directory what you want. Then extract 'src.zip' into the directory. 
And apply 'os2.diff' to the sources as the following.

    patch -p0 < os2.diff
  
8.4.2 generating 'config' file
------------------------------

  Now, you should copy config files to *.exe.

    ex) copy dvdnav-config dvdnav-config.exe
   
8.4.3 setting environmental variables for pkg-config
----------------------------------------------------

  Set environmental variables for pkg-config as the following.
  
    SET PKG_CONFIG_ALLOW_SYSTEM_CFLAGS=1
    SET PKG_CONFIG_ALLOW_SYSTEM_LIBS=1
     
8.4.4 setting a linker to WLINK
-------------------------------
   
  Set linker to WLINK.
  
    ex) gccenv gcc-usr-directory WLINK

8.4.5 Modifying 'configure.cmd'
-------------------------------

  Modify configure.cmd in a source package as the following.
  
    .Modify _QT4BASE to the path where Qt4 is installed
    .Modify _LIVE555_TREE to the path where live555 is installed
    .Modify _MOZILLA_SDK_ATH to the path where Mozilla pluing SDK is installed
    
  If you don't need live555 or Mozilla plugin, remove the lines specyfing 
options in configure.cmd

  Copy it to the top source directory of VLC. Now run configure.cmd in the top 
source directory.

8.4.6 Compiling and Installing
------------------------------

  After configuring, run the following.
  
    make SHELL=/bin/sh
    
  After compiling, run the following.
  
    make SHELL=/bin/sh install
    
  Then, VLC is installed in /usr/local.
  
9. Official homepage of VLC media player
----------------------------------------

  The official homepage of VLC media player is

    http://www.videolan.org/vlc/
    
  Refer to the following for the basic use of VLC( Reported by Ed Durrant )
    
    http://www.videolan.org/doc/play-howto/en/ch03.html
    
10. Donation
------------

  If you are satisfied with this program and want to donate to me, please visit
the following URL.

    http://www.ecomstation.co.kr/komh/donate.html
      
11. Contacts...
---------------

  e-mail : komh@chollian.net
  ICQ    : 124861818
  MSN    : komh@chollian.net
  IRC    : lvzuufx, #os2 at HANIRC(irc.hanirc.org)

KO Myung-Hun
