View source for Win32CompileCygwinNew

This is a new version of the Win32CompileCygwin written by Jean-Baptiste Kempf


=Introduction=

This is a guide for Windows users with a step-by-step instruction to download, install, configure and build your VLC.

This guide uses [http://www.cygwin.com '''Cygwin'''] a Linux-like environment for Windows used for compilation of the VLC source code.

Start off by creating a VLC and a download folder on your hard drive where you can put all the installation files:

 C:\VLC\
 C:\VLC\Downloads

For further reference, the assumption is made that the local user will be 'Administrator'.

=Cygwin=

Download the latest [http://www.cygwin.com/cygwin/setup.exe Cygwin setup] and save it in your download location:

 C:\VLC\Downloads\

More info about Cygwin can be found at http://www.cygwin.com or http://sourceware.org/cygwin

==Selecting Cygwin packages to install==

Run the setup program with the following options:

Installation type : Install from Internet (default)

Root directory : C:\cygwin (default)

Local Package directory : C:\VLC\Downloads\cygwin (your download location)

Internet Connection : Direct Connection (preferred, if it fails try another)

Download Site : Choose a download site closest to you (FTP preferred)


At the "Select Packages" section of the installation process you can select packages by clicking the button with the rotating 2 arrows. (This is under the "New" section). It shows "Skip" next to the button if the package isn't selected yet.

Clicking the button a few times will rotate through the possible package versions including "Skip" (meaning do not install or remove if installed) and "Keep" (meaning keep using the current installed version). If a package was already installed it will also show the "Current" version just to the left of it.

Select the following packages (some others will automatically be selected as well):

 Archive
   unzip
   zip

 Devel
   autoconf
   automake
   binutils
   cvs
   expat
   gcc
   gcc-core
   gcc-g++
   gcc-mingw
   gcc-mingw-core
   gcc-mingw-g++
   gdb
   gettext
   gettext-devel
   git
   libtool1.5
   make
   mingw-runtime
   nasm
   patchutils
   pkg-config
   subversion
 
 Editor
   vim

 Lib
   libgcrypt

 Web
   curl (optional: for building extras/contrib)
   wget (optional: for building extras/contrib)


==Cygwin environment==

Start Cygwin from the icon on your desktop. If it runs for the first time it will automatically create a home\"username" folder in the Cygwin environment; user being the currently logged on Windows user. Assuming this is the 'Administrator' user it will create the following folder:

 C:\cygwin\home\Administrator (example)

NOTE: On your desktop, you can rightclick the Cygwin icon and (in the Options field of the Cygwin Properties) set the Command history Buffer size to as large as possible: 999. This setting will make it possible to scroll back further in the Cygwin environment.


=VLC source code=

== SVN ==
The very latest VLC source code can be obtained through a tool called SVN (Subversion). The Cygwin package we're about to install comes with an internal subversion component.

 cd /cygdrive/c/VLC/

 svn co svn://svn.videolan.org/vlc/trunk vlc-trunk

== Snapshots ==

You can do the same by using the snapshots in the nightly builds site.

=Bootstrap=

Open the configure.ac file, and modify the requirement for gettext 0.16.1 to 0.15.

 cd vlc-trunk
 ./bootstrap

= External libraries to the source code=

VLC depends on other libraries (code) to provide some features like AC3 audio or MPEG-4 video encoding/decoding etc.

Depending on your needs you will have to install and compile some or all of these external libraries. 

== Win32 "contrib" package ==

A package with most of these libraries already compiled so it's actually really easy to compile a full-featured version of vlc can be found here:

http://download.videolan.org/pub/testing/win32/

Download the latest version of a "contrib" package for win32:

 contrib-20060730-win32-bin-gcc-3.4.5-only.tar.bz2 (example)

Those days, you should use
 http://people.videolan.org/~jb/Contribs/contrib-20080215-win32-bin-gcc-4.2.1-sjlj-runtime-3.13-only.tar.bz2


It's a good idea to check the INSTALL.Win32 file in the VLC source directory for the appropriate contrib download file.

Save it into your download location:

 C:\VLC\Downloads\


==Installing the Win32 "contrib" package in Cygwin==

Start Cygwin and enter the following command in your shell:

 cd /cygdrive/c/VLC/Downloads
 tar xf contrib-20080215-win32-bin-gcc-4.2.1-sjlj-runtime-3.13-only.tar.bz2 -C /

Replace with your version of the "contrib" file and DON'T FORGET THE / (slash)
at the end.

This will extract the contents of the file into usr/win32 folder within your Cygwin environment.

NOTE: Make sure to DELETE your old version instead of extracting a new version on top of it.

==Keeping the Win32 "contrib" package up-to-date==

For maintenance purposes periodically check:

http://download.videolan.org/pub/testing/win32/

to see if a newer "contrib" is available. If that is the case you should DELETE the existing directory structure which is for the precompiled "contrib" package:

 C:\cygwin\usr\win32 (example)

Download the newer file and follow the installation instructions the same as before so you will end up with the most up-to-date version.

NOTE: Make sure to DELETE your old version instead of extracting a new version on top of it.


=Configure=

In order to make our lives just a bit easier the following section describes what commandline options should be used for compiling and those commands will then be put into a "script" that can be executed (rather than having to copy and paste all the time).


==Configure script for compiling VLC==

Create a new text document with the following lines:

  CONTRIB_TREE=/usr/win32
  PATH=${CONTRIB_TREE}/bin:$PATH \
  ./bootstrap && \
  CPPFLAGS="-I${CONTRIB_TREE}/include -I${CONTRIB_TREE}/include/ebml" \
  LDFLAGS=-L${CONTRIB_TREE}/lib \
  PKG_CONFIG_LIBDIR=${CONTRIB_TREE}/lib/pkgconfig \
  CC="gcc -mno-cygwin" CXX="g++ -mno-cygwin" \
  ./configure \
      --host=i686-pc-mingw32 \
      --enable-sdl --with-sdl-config-path=${CONTRIB_TREE}/bin --disable-gtk \
      --enable-nls \
      --enable-ffmpeg --with-ffmpeg-mp3lame --with-ffmpeg-faac \
      --with-ffmpeg-zlib --enable-faad --enable-flac --enable-theora \
      --with-wx-config-path=${CONTRIB_TREE}/bin \
      --with-freetype-config-path=${CONTRIB_TREE}/bin \
      --with-fribidi-config-path=${CONTRIB_TREE}/bin \
      --enable-live555 --with-live555-tree=${CONTRIB_TREE}/live.com \
      --enable-caca --with-caca-config-path=${CONTRIB_TREE}/bin \
      --with-xml2-config-path=${CONTRIB_TREE}/bin \
      --with-dvdnav-config-path=${CONTRIB_TREE}/bin \
      --disable-cddax --disable-vcdx --enable-goom \
      --enable-twolame --enable-dvdread \
      --disable-gnomevfs \
      --enable-dts \
      --disable-optimizations \
      --enable-debug \

NOTE: The following option is added for DTS Coherent Acoustics streams decoding support. The latest "contrib" package should already contain libdca (formerly known as libdts) needed to compile this but at present it's disabled by default:

 --enable-dts

NOTE: For VLC 0.9.0, replace the previous option by:

 --enable-dca

NOTE: The following options are added for debug purposes and makes the final package a bit larger but the advantage is it's easier to debug in case of crash reports:

 --disable-optimizations
 --enable-debug

If you want to report a crash bug to the VLC team, it is necessary that you provide a stack backtrace. Unfortunately, Windows automatic crash reporter cannot generate such a backtrace as debug symbols used by GCC compiler aren't understood by Windows, therefore we suggest that you install Dr. MinGW (http://jrfonseca.dyndns.org/projects/gnu-win32/software/drmingw/) which will extend Windows Just-In-Time Debugger and provide the necessary debug information.

NOTE: The following options is needed for QT4 support:

 --enable-qt4

As of version 0.9.0 VLC will include the QT interface. More information can be found about QT here: http://www.trolltech.com

The "Win32 contrib package" at present only includes the linux equivalents of uic, moc and roc executables which are required for building this interface.

The linues executables have to be '''deleted''' from the contrib folder:

 C:\cygwin\usr\win32\bin\moc (example)
 C:\cygwin\usr\win32\bin\rcc (example)
 C:\cygwin\usr\win32\bin\uic (example)

The moc, rcc and uic.exe from the [http://www.trolltech.com/developer/downloads/qt/windows Qt/Windows Open Source Edition] (these can be found in the bin folder after installation) have to be placed in the contrib folder:

 C:\cygwin\usr\win32\bin\moc.exe (example)
 C:\cygwin\usr\win32\bin\rcc.exe (example)
 C:\cygwin\usr\win32\bin\uic.exe (example)
 
Save as filename in your "scripts" folder at your download/install location:

 configure-vlc.sh

NOTE: Save using "All files" and not "Text files" otherwise Windows might append the extension .txt

Copy the file into your home directory:
 
 C:\cygwin\home\Administrator

Start Cygwin and enter the following command in your shell: 

 dos2unix configure-vlc.sh


===POSIX emulation layer===

VLC can be built with or without the so called POSIX emulation layer. Without is the default and is usually better (and with hasn't been tested for quite some time). If you do want to use the emulation layer, then just leave out the line with the following options:

 CC="gcc -mno-cygwin" CXX="g++ -mno-cygwin"


=Compiling source code=

It's time to start Cygwin again...

==Compiling VLC==

Enter the following commands in your Cygwin shell:

 cd vlc-trunk

(you can check with the pwd command to see in which folder you are and with just the cd
command without any additional parameters you can change back to your home directory).

NOTE: The following line is optional, only use that if you have problems compiling.

 ./toolbox --distclean

(This will have removed everything except code related stuff).

 ../configure-vlc.sh

 make

Cross your fingers...

NOTE: ./ means you run an application/script from the "current folder" (which is vlc-trunk) and ../ points to "one directory up" (which is where configure-vlc.sh is).

==Creating self contained packages==

Once the compilation is done, you can either run VLC directly from the source tree or you can build self-contained VLC packages with the following "make" commands:

 make package-win32-base

(This will create a subdirectory named vlc-x.x.x with all the binaries "stripped" without any debugging symbols).

 make package-win32-zip

(Same as above but will package the directory in a zip file).

 make package-win32

(Same as above but will also create an auto-installer package. You will need to have NSIS installed in its default location for this to work).


=Advanced usage=


==Updating Cygwin package versions==

If you need to update or install additional packages you can just run the Cygwin setup.exe from your download location:

 C:\Downloads\cygwin\setup.exe          (example)


==GDB (Gnu Debugger)==

This section requires that you installed the gdb (Gnu Debugger) in Cygwin.

This is a typical example of creating a crashlog:

 cd vlc-trunk

 gdb --args vlc.exe --fast-mutex --reset-config --reset-plugins-cache

NOTE: vlc-0.9.0 uses libtool for building sources, if you want to debug from the source tree, you should type the following command instead:

 libtool -mode=execute gdb --args vlc --reset-config --reset-plugins-cache

In the debugger mode run the program and make sure you reset the preferences!

 (gdb) run 

NOTE: the (gdb) is just a prompt which means you are in the debugger mode, please note that ''--fast-mutex'' option is no longer supported in vlc-0.9.0

It will now take a lot longer than usual for VLC to start :)

Now operate VLC as you would normally do. As soon as a crash issue occurs
you'll notice a line like this:

 Program received signal SIGSEGV, Segmentation fault.
 0x0041394c in playlist_ItemGetById (p_playlist=0x19ec4f8, i_id=29)
     at src/playlist/item-ext.c:459
 ---Type <return> to continue, or q <return> to quit---
 459             i = i_bottom + ( i_top - i_bottom ) / 2;

Now you can do a "backtrace" by using the bt command:

 (gdb) bt

And output similar to this will be created:

 #0  0x0041394c in playlist_ItemGetById (p_playlist=0x19ec4f8, i_id=29) 
     at src/playlist/item-ext.c:459
 #1  0x0b26bbf7 in wxvlc::Playlist::CountItems (this=0x1822e288, root=
       {m_pItem = 0x29fef8}) at playlist.cpp:695
 #2  0x0b26bc83 in wxvlc::Playlist::CountItems (this=0x1822e288, root=
       {m_pItem = 0x29e8b0}) at playlist.cpp:689
 #3  0x0b26bc83 in wxvlc::Playlist::CountItems (this=0x1822e288, root=
       {m_pItem = 0x29a818}) at playlist.cpp:689
 #4  0x0b26bc83 in wxvlc::Playlist::CountItems (this=0x1822e288, root=
       {m_pItem = 0x299718}) at playlist.cpp:689
 #5  0x0b26bc83 in wxvlc::Playlist::CountItems (this=0x1822e288, root=
       {m_pItem = 0xffff0000}) at playlist.cpp:689
 #6  0x0b26bf49 in wxvlc::Playlist::AppendItem (this=0x1822e288,
     event=@0x1827afd0) at playlist.cpp:564
 #7  0x0b2757fc in wxvlc::Playlist::OnPlaylistEvent (this=0x1822e288,
     event=@0x1827afd0) at playlist.cpp:1438
 #8  0x0b3771b8 in wxEvtHandler::ProcessEventIfMatches ()
     at /usr/win32/include/wx-2.6/wx/event.h:2183
 #9  0x0b376a1c in wxEventHashTable::HandleEvent ()
     at /usr/win32/include/wx-2.6/wx/event.h:2183
 #10 0x0b37730d in wxEvtHandler::ProcessEvent ()
     at /usr/win32/include/wx-2.6/wx/event.h:2183
 #11 0x0b37711b in wxEvtHandler::ProcessPendingEvents ()
     at /usr/win32/include/wx-2.6/wx/event.h:2183
 ---Type <return> to continue, or q <return> to quit---
 #12 0x0b376017 in wxAppConsole::ProcessPendingEvents ()
     at /usr/win32/include/wx-2.6/wx/event.h:2183
 #13 0x0b3ec75a in wxIdleWakeUpModule::MsgHookProc ()
     at /usr/win32/include/wx-2.6/wx/bmpbuttn.h:81
 #14 0x773aca2d in USER32!GetScrollRange ()
    from /cygdrive/c/WINDOWS/system32/user32.dll
 #15 0x00000000 in ?? () from
 (gdb)

These are the log outputs that are more usefull to developers than just mentioning "it crashes"!

NOTE: In GDB mode there are sometimes situations where GDB initially "crashes" on certain network activity (opening network shares, network traffic) which in normal operation does not occur. Just select c for continue until "normal" operation continues.

==.diff files==

Frequently patches to source code are presented or discussed in forums or in mailing lists in so called .diff format (these are "differences" to the source code).

You can apply those patches yourself to the source code or create .diff files. This requires the patchutils package in Cygwin.


===Patching source code===

Download a so called .diff file:

 sse2-pixel-routines-v3.diff (example)

NOTE: make sure the file doesn't get a .txt extension, so Save as type "All Files" instead of "Text Document" (IE has a habit of renaming to .txt. If that happens just simply rename to .diff)

Copy the .diff file into the appropriate source folder

 x264-trunk (example)

Apply the patch as follows

 patch -p0 < sse2-pixel-routines-v3.diff (example)

NOTE: replace sse2-pixel-routines-v3.diff with your "patch"

This will output something like:

 patching file common/i386/pixel.h
 patching file common/i386/pixel-a.asm
 patching file common/pixel.c

Your source code is now patched!

NOTE: If you want to revert to the original version you can use the -R option with the patch command or alternatively you can just delete the changed files and just do an SVN update to get the original/latest SVN version back.


===Creating .diff files===

When changing the source code it's possible to create a "difference" file against the latest source.

In this example the file /modules/codec/x264.c was changed (the part "in kbit/s" was added to a description).

Start your Cygwin shell.

Change to the appropriate folder where a changed file is.

 cd vlc-trunk/modules/codec (example)

Output the svn diff command to a file:

 svn diff -u > x264-patch.diff

The current folder now holds a x264-patch.diff file containing the following:

 Index: x264.c
 ===================================================================
 --- x264.c      (revision 15921)
 +++ x264.c      (working copy)
 @@ -131,7 +131,7 @@
  #define RATETOL_LONGTEXT N_( "Allowed variance in average. " \
      "bitrate (in kbits/s).")
 
 -#define VBV_MAXRATE_TEXT N_("Max local bitrate")
 +#define VBV_MAXRATE_TEXT N_("Max local bitrate in kbit/s")
  #define VBV_MAXRATE_LONGTEXT N_( "Sets a maximum local bitrate in kbits/s.")
 
  #define VBV_BUFSIZE_TEXT N_("VBV buffer")

NOTE: In Windows you should open this file with something else than notepad (so wordpad or some more advanced editor). This has to do with the end of line markers that are present in the file since it was made in a Linux environment.


==vlc.exe: Permission denied==

A make finished successfully and produced vlc.exe, but running the executable returns the following:

 bash: ./vlc.exe: Permission denied

The permissions on both vlc.exe & vlc.exe.manifest must be set to executable. 

FIX: Type the following:
 
 chmod 755 vlc.exe vlc.exe.manifest

==error: parse error before '(' token==

A make (compile) of FFmpeg results in the following error:

 /usr/include/sys/unistd.h:203: error: parse error before '(' token
 make[1]: *** [ffm.o] Error 1

It's very likely you are usix the POSIX emulater which you shouldn't...

FIX: compile with the option 

 -mno-cygwin


==error: invalid conversion from `const void*' to `void*'==

 src/theme_loader.cpp: In function `int gzwrite_frontend(int, const void*, size_t)':
 src/theme_loader.cpp:599: error: invalid conversion from `const void*' to `void*'
 src/theme_loader.cpp:599: error:   initializing argument 2 of `int gzwrite(void*,
 void*, unsigned int)'
 make[6]: *** [libskins2_plugin_a-theme_loader.o] Error 1

FIX: This is related to a problem with the zlib library, updating to at least 1.2.2-1 but preferably 1.2.3 or newer is required


==error: cannot convert `const wxChar*' to `const char*==

 if g++ -mno-cygwin -DHAVE_CONFIG_H -I. -I. -I../../..   -I/usr/win32/include -I/
 usr/win32/include/ebml -D_OFF_T_ -D_off_t=long -DSYS_MINGW32 -I../../../include
 `top_builddir="../../.." ../../../vlc-config --cxxflags plugin wxwidgets` -Wsign
 -compare -Wsign-compare -Wall  -mms-bitfields -pipe -MT libwxwidgets_plugin_a-wx
 widgets.o -MD -MP -MF ".deps/libwxwidgets_plugin_a-wxwidgets.Tpo" -c -o libwxwid
 gets_plugin_a-wxwidgets.o `test -f 'wxwidgets.cpp' || echo './'`wxwidgets.cpp; \
 then mv -f ".deps/libwxwidgets_plugin_a-wxwidgets.Tpo" ".deps/libwxwidgets_plugi
 n_a-wxwidgets.Po"; else rm -f ".deps/libwxwidgets_plugin_a-wxwidgets.Tpo"; exit
 1; fi
 In file included from /usr/win32/include/wx-2.6/wx/debug.h:22,
                  from /usr/win32/include/wx-2.6/wx/defs.h:452,
                  from /usr/win32/include/wx-2.6/wx/wxprec.h:13,
                  from wxwidgets.h:40,
                  from wxwidgets.cpp:39:
 /usr/win32/include/wx-2.6/wx/wxchar.h: In function `size_t wxStrlen(const wxChar
 *)':
 /usr/win32/include/wx-2.6/wx/wxchar.h:759: error: cannot convert `const wxChar*'
  to `const char*' for argument `1' to `size_t strlen(const char*)'
 In file included from /usr/win32/include/wx-2.6/wx/memory.h:20,
                  from /usr/win32/include/wx-2.6/wx/object.h:25,
                  from /usr/win32/include/wx-2.6/wx/wx.h:16,
                  from wxwidgets.h:41,
                  from wxwidgets.cpp:39:
 /usr/win32/include/wx-2.6/wx/string.h: In constructor `wxString::wxString(const
 wxChar*)':

FIX: update wxwidgets or try a different or newer Win32 "contrib" package.


==undefined reference to `_av_parser_change' (FFmpeg)==

 ffmpeg.o: In function `output_packet':
 /home/Administrator/FFmpeg-20050724/ffmpeg.c:1414: undefined reference to `_av_parser_change'
 /home/Administrator/FFmpeg-20050724/ffmpeg.c:1415: undefined reference to `_av_destruct_packet'
 collect2: ld returned 1 exit status
 make: *** [ffmpeg_g.exe] Error 1

This is a possible conflict when you use normal configure-ffmpeg (uses /usr/win32
contrib) instead of configure-ffmpeg-svn


==undefined reference to `_pp_get_context' (FFmpeg)==

 ./modules/codec/ffmpeg/libffmpeg.a(libffmpeg_a-postprocess.o): In function `Init
 Postproc__ffmpeg':
 /home/Administrator/vlc-trunk/modules/codec/ffmpeg/postprocess.c:164: undefined
 reference to `_pp_get_context'
 ./modules/codec/ffmpeg/libffmpeg.a(libffmpeg_a-postprocess.o): In function `PPQC
 allback':
 /home/Administrator/vlc-trunk/modules/codec/ffmpeg/postprocess.c:244: undefined
 reference to `_pp_get_mode_by_name_and_quality'
 ./modules/codec/ffmpeg/libffmpeg.a(libffmpeg_a-postprocess.o): In function `Post
 procPict__ffmpeg':
 /home/Administrator/vlc-trunk/modules/codec/ffmpeg/postprocess.c:191: undefined
 reference to `_pp_postprocess'
 $
 ePostproc__ffmpeg':
 /home/Administrator/vlc-trunk/modules/codec/ffmpeg/postprocess.c:209: undefined
 reference to `_pp_free_mode'
 /home/Administrator/vlc-trunk/modules/codec/ffmpeg/postprocess.c:210: undefined
 reference to `_pp_free_context'
 collect2: ld returned 1 exit status
 make[2]: *** [vlc.exe] Error 1
 make[2]: Leaving directory `/home/Administrator/vlc-trunk'
 make[1]: *** [all-recursive] Error 1
 make[1]: Leaving directory `/home/Administrator/vlc-trunk'
 make: *** [all] Error 2

FFmpeg was not compiled with post processing support. To do so the following options need to be added to the configure lines for FFmpeg:

 --enable-pp --enable-gpl

Postprocessing code is under GPL.


==error: expected primary-expression before '<<' token==

 In file included from /usr/lib/gcc/i686-pc-mingw32/3.4.4/../../../../include/w32
 api/windows.h:52,
                  from ../../../include/vlc_common.h:459,
                  from ../../../include/vlc/vlc.h:153,
                  from dshow.cpp:31:
 /usr/lib/gcc/i686-pc-mingw32/3.4.4/../../../../include/w32api/wingdi.h:3:1: warn
 ing: this is the location of the previous definition
 In file included from /usr/win32/include/dshow.h:35,
                  from common.h:45,
                  from dshow.cpp:35:
 /usr/win32/include/ddraw.h:14: warning: ignoring #pragma warning
 In file included from /usr/win32/include/dshow.h:35,
                  from common.h:45,
                  from dshow.cpp:35:
 /usr/win32/include/ddraw.h:5552: warning: ignoring #pragma warning
 In file included from /usr/win32/include/dshow.h:45,
                  from common.h:45,
                  from dshow.cpp:35:
 /usr/win32/include/strmif.h:2: warning: ignoring #pragma warning
 In file included from /usr/win32/include/dsound.h:13,
                  from /usr/win32/include/amaudio.h:18,
                  from /usr/win32/include/dshow.h:47,
                  from common.h:45,
                  from dshow.cpp:35:
 /usr/win32/include/d3dtypes.h:22: warning: ignoring #pragma warning
 /usr/win32/include/d3dtypes.h:1813: warning: ignoring #pragma warning
 In file included from /usr/win32/include/dshow.h:48,
                  from common.h:45,
                  from dshow.cpp:35:
 /usr/win32/include/control.h:2: warning: ignoring #pragma warning
 dshow.cpp: In function `int CommonOpen(vlc_object_t*, access_sys_t*, vlc_bool_t)
 ':
 dshow.cpp:456: error: expected primary-expression before '<<' token
 dshow.cpp:456: error: expected primary-expression before '<<' token
 dshow.cpp:456: error: expected primary-expression before '<<' token
 dshow.cpp:456: error: expected primary-expression before '<' token
 dshow.cpp:456: error: expected primary-expression before '.' token
 dshow.cpp:470: error: expected primary-expression before '==' token
 dshow.cpp:470: error: expected primary-expression before '==' token
 dshow.cpp:470: error: expected primary-expression before '==' token
 dshow.cpp:470: error: expected primary-expression before '=' token
 dshow.cpp:484: error: expected primary-expression before '>>' token
 dshow.cpp:484: error: expected primary-expression before '>>' token
 dshow.cpp:484: error: expected primary-expression before '>>' token
 dshow.cpp:484: error: expected primary-expression before '>' token
 dshow.cpp:484: error: expected primary-expression before '.' token
 dshow.cpp:485: error: expected `;' before "IAMCrossbar"
 dshow.cpp:491: error: `pXbar' undeclared (first use this function)
 dshow.cpp:491: error: (Each undeclared identifier is reported only once for each
 function it appears in.)
 make[6]: *** [libdshow_plugin_a-dshow.o] Error 1
 make[6]: Leaving directory `/home/Administrator/vlc-trunk/modules/access/dshow'
 make[5]: *** [all-modules] Error 1
 make[5]: Leaving directory `/home/Administrator/vlc-trunk/modules/access/dshow'
 make[4]: *** [all-recursive] Error 1
 make[4]: Leaving directory `/home/Administrator/vlc-trunk/modules/access'
 make[3]: *** [all] Error 2

Basically in case of conflict svn adds "<<< mine" and "=======" and ">>>> r1242" which makes gcc complain.

FIX: revert the offending file


==configure: error: Could not find ffmpeg on your system==

 configure: error: Could not find ffmpeg on your system: you may get it from
 http://ffmpeg.sf.net/ (cvs version is recommended). Alternatively you can use
 --disable-ffmpeg to disable the ffmpeg plugins.
 make: *** [config.status] Error 1

This can happen when you do a make without doing a configure and the configure.ac file in the source code recently updated.

FIX: do a full configure (using ../configure-vlc.sh) and then run the make process


==Objective C source seen but `OBJC' is undefined==

The configure process stops halfway.

 + aclocal-1.9 -I m4
 + autoconf
 + autoheader
 + automake-1.9 --add-missing --copy -Wall
 configure.ac: installing `autotools/install-sh'
 configure.ac: installing `autotools/missing'
 activex/Makefile.am:143: shell $(VLC_CONFIG: non-POSIX variable name
 activex/Makefile.am:143: (probably a GNU make extension)
 activex/Makefile.am: installing `autotools/compile'
 activex/Makefile.am: installing `autotools/depcomp'
 modules/gui/macosx/Makefile.am: Objective C source seen but `OBJC' is undefined
 modules/misc/testsuite/Makefile.am: Objective C source seen but `OBJC' is undefi
 ned
 src/Makefile.am: Objective C source seen but `OBJC' is undefined
 Makefile.am:282: user target `vlc$(EXEEXT)' defined here...
 /usr/share/automake-1.9/am/program.am: ... overrides Automake target `vlc$(EXEEX
 T)' defined here
 Makefile.am:230:   while processing program `vlc'
 make: *** No targets specified and no makefile found.  Stop.
 
This problem is related to a warning earlier on and only occured in a few revisions where a built-in workaround wasn't working properly:

 + echo 'Enabling provisional autoconf 2.59 work-around. Update autoconf ASAP.'
 Enabling provisional autoconf 2.59 work-around. Update autoconf ASAP.

FIX: update autoconf to 2.60 or newer. If Cygwin doesn't provide this version yet then build it yourself from extras/contrib.

Enter the following commands in your Cygwin shell:

 cd vlc-trunk/extras/contrib

 ./bootstrap

 cd src

 make .autoconf

There should now be compiled autoconf version (probably 2.60 or newer) in extras/contrib that the bootstrap process will use.

Now start the whole "Compile VLC" process from the start again.

==Error: cannot create temporary file for diversion: Permission denied==

If the above error appears, it might mean you don't have the TMPDIR defined in cygwin. You will need to define it and have its value point to your temporary directory.

=Version=

20050627 Initial version

20050628 Updated some more exceptions

20050628 Some info added about FFmpeg compiling with AMR

20050629 Finalized FFmpeg compiling

20050630 Cross-compiling

20050724 Some extra compile explanations

20050726 Removed cross-compiling (was for linux -> win32) Patching source code with .diff files

20050823 Added zlib error

20050923 --enable-sdl --with-sdl-config-path=/usr/win32/bin added to configure. Added debug section

20051102 Changed FFmpeg lib names

20051128 Detailed Cygwin upgrade/downgrade for gcc 3.3. Renamed some update scripts. Added FFmpeg CVS update. --disable-gnomevfs added to configure (only used on linux)

20060121 PKG_CONFIG_PATH=/usr/win32/lib/pkgconfig added to configure

20060128 Added curl and libtool to Cygwin for those that want to be able to build extras/contrib themselves

20060217 Added make install-libs install-headers to FFmpeg compile

20060222 Remark about missing "gettext" libs for Cygwin during install

20060225 ./bootstrap: you need libtool

20060618 Updated GCC to 3.4 version and added FFmpeg SVN and DTS support

20060805 Added note about using older binutils and gdb for Cygwin!

20060915 Added note about updating autoconf from extras/contrib for an OBJC problem during configure

20061108 Added note this document is no longer usable since Cygwin has been unusable probably related to some bash/dos2unix change

20070612 Added note about --enable-dca

[[Category:Building]]
[[Category:Coding]]