@@ -1,27 +1,21 @@ = Introduction = -This document describes how to build e, including its dependencies. +This document describes how to build e & its dependencies. To build e you will need: * A copy of Visual C++ 2008 ** You can get the free express edition at http://www.microsoft.com/express/vc/ ** Full Visual Studio versions also work fine. -** Note that opening a 2008 .sln file created with the Express version may still - prompt you to "upgrade" the .sln if you open it with a full Visual Studio SKU. * A set of GNU tools for Windows (including bash, patch, wget, etc.) ** Cygwin and Msys both support these tools. ** You'll probably end up with both anyway, Cygwin for e support and Msys for git support. -To build e you will need a copy of Visual C++ 2008. -* Any version of Visual Studio 2008 will also work, of course. -* Note that opening a 2008 .sln file created with the Express version may still - prompt you to upgrade the .sln if you open it with a full Visual Studio SKU. = Building the Dependencies = -e's code dependencies are: +e's dependencies are: * wxWidgets * Metakit * PCRE @@ -34,13 +28,14 @@ e's code dependencies are: To download, patch and compile these dependencies: * Run "get_externals_win.sh" in a cygwin shell. * Run "build_externals_win.cmd" in a VS2008 Command Prompt. +** If you do not have the full Visual Studio, you will have to compile the +** dependencies separately in the GUI, for now. Later versions of these projects may work with e, but have not been tested. -Consult the "get_externals_win.sh" script to see what the expected version of a dependency is. +Consult the "get_externals_win.sh" script to see what the expected versions are. = Building e Itself = * After building all the dependencies, open "e.sln" and build the Debug target. -* Note that the resulting e.exe in "Debug" has no idea where Themes/Bundles/Support/etc. are. -* If you want to run the new "e.exe", you'll need to provide it with the support files. -** One way to do this is to copy over the support folders from your licensed copy in "C:\Program Files\e". +* The newly build "e" will use configuration in the registry from an installed + license or trial version. building.txt @@ -23,15 +23,18 @@ goto :EOF REM **** Subroutines start here **** +REM Usage: call :BUILD path_to_sln [, config_to_build=DEBUG] :BUILD setlocal -REM Args are: path_to_sln, [config_to_build=DEBUG] set CONFIG=%2 if {%CONFIG%}=={} set CONFIG="DEBUG" echo Building %1... devenv %1 /Build %CONFIG% > build_logs\%~n1.log set RET=%ERRORLEVEL% +REM "mspdbsrv.exe" can hang, which prevents new .pdb's from +REM being created and causes subsequent command-line builds to fail. +REM Explicitly try to kill it after a command-line build. taskkill.exe /f /t /im mspdbsrv.exe > nul 2> nul endlocal & set RET=%RET% goto :EOF external/build_externals_win.cmd @@ -81,18 +81,18 @@ _extract_and_patch() _next_steps() { - echo "** The libraries have been installed. **" - echo "Now you just need to build the following projects in msvc:" + echo "** The libraries have been downloaded and patched. **" + echo "Now build the following projects in Visual Studio:" echo - echo "curl\lib\curllib.sln (curllib)" - echo "libtomcrypt\libtomcrypt.sln (libtomcrypt)" - echo "libtommath\libtommath.sln (libtommath)" - echo "metakit\win\msvc90\mksrc.sln (mklib)" - echo "pcre\pcre.sln (pcre)" - echo "tinyxml\tinyxml.sln (tinyxml)" - echo "wxwidgets\build\msw\wx.dsw (wx)" + echo "curl\lib\curllib.sln" + echo "libtomcrypt\libtomcrypt.sln" + echo "libtommath\libtommath.sln" + echo "metakit\win\msvc90\mksrc.sln" + echo "pcre\pcre.sln" + echo "tinyxml\tinyxml.sln" + echo "wxwidgets\build\msw\wx.dsw" echo - echo "Run build_externals_win.cmd in a Visual Studio 2008 Command Prompt to compile from the command-line." + echo "For an automated build, run build_externals_win.cmd in a Visual Studio 2008 Command Prompt." } external/get_externals_win.sh @@ -1,5 +1,3 @@ To-do: -* Revamp build instructions (the easy way vs. the hard way) -* Get a working build; build currently succeeds but menus paint incorrectly. +* Linux builds. * Unit/regression test suites. -* Allow wget or curl to get dependencies. todo.txt 230dee019764985d2d4add61a6540fbc49f1fae7 Adam Vandenberg flangy@gmail.com http://github.com/tea/e/commit/86b1c2b42e67c4ec0ba7276691126b00ef1dbe7a 86b1c2b42e67c4ec0ba7276691126b00ef1dbe7a 2009-04-07T09:16:59-07:00 2009-04-07T09:16:59-07:00 Edits to build instructions. 9a95e32158e9a52659e7c0848f9909ba00521400 Adam Vandenberg flangy@gmail.com