--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/webengine/osswebengine/Bakefiles/Readme.txt	Mon Mar 30 12:54:55 2009 +0300
@@ -0,0 +1,99 @@
+WebKit Bakefile Docs
+
+The files in this folder are used to auto-generate project files in GNU
+Make and Microsoft Visual Studio 6 (can be used in 7 and 8 too). Support
+for many other formats are available, including eVC (for PocketPC),
+autoconf, and Symbian project formats, so most future ports would be
+able to take advantage of Bakefile support for their projects. (XCode
+also has a partial backend in place, but it's not in a usable state for
+this project.)
+
+The project files generated using Bakefile currently reside in the
+WebCore/Projects/<Project Name> folder. There are not any JavaScriptCore
+Bakefiles yet as it build successfully pretty much everywhere already.
+However, a Bakefile-based project management system might reduce the
+maintenance burden of maintaining the JavaScriptCore project files too,
+eventually.
+
+
+Preparing the build environment
+--------------------------------
+
+Right now, the prepartion steps are not totally automated. Here are the steps
+that need to be taken at present before you build. 
+
+IMPORTANT: If you already have a copy of Bakefile 0.2.0 installed, you need to
+update your version to a modified 0.2.0 release with MSVS 2005 support. (If you 
+haven't installed it, regenerate-makefiles will take care of it for you.) You can
+get the release from here:
+
+http://kevino.theolliviers.com/bakefile-0.2.0-msvs2005.tar.gz
+
+This support will be officially in a future Bakefile release.
+
+--- On Unix, do the following:
+
+cd WebKitTools/Scripts
+sudo ./install-unix-extras # or su, needed for make install
+
+--- On Windows, do the following:
+
+cd WebKitTools/Scripts
+./install-win-extras
+
+
+Building the projects 
+----------------------
+
+cd into the project directory (WebKit/JavaScriptCore and 
+WebKit/WebCore/Projects/wx, respectively) and run the following:
+
+-- On Unix:
+
+make
+
+-- On Windows, you should open and build the .sln projects.
+
+Windows Note: Sometimes, the files generated by the pre-build step don't get
+built and you get an error during linking. However, a subsequent build resolves
+the issue.
+
+
+Regenerating the Makefiles 
+---------------------------
+
+cd into the WebCore/WebKitTools/Scripts directory and run the
+./regenerate-makefiles script to recreate the makefiles. This will download
+and install Bakefile if you don't have it installed already. (You may need to
+authenticate if it needs to install Bakefile.)
+
+
+Regenerating the source file lists 
+------------------------------------
+Currently, WebCoreSources.bkl and JavaScriptCore.bkl files are
+autogenerated by reading the .vcproj files and extracting the file lists
+from them, using update-file-lists.py. Whenever files are added/removed,
+you should re-run 'python update-file-lists.py' to put the *Sources.bkl back in
+sync with TOT. When the script is run, however, there are also currently two 
+source files that need to be manually removed:
+
+In JavaScriptCoreSources.bkl
+- ./grammarWrapper.cpp
+
+In WebCoreSources.bkl
+- $(SRCDIR)/rendering/RenderThemeWin.cpp 
+
+Eventually, we need a way to ensure that these files get included only for
+Win builds. Either we find a solution so that we no longer need to autogenerate
+the source file list, or we move them in the vcproj to some sort of 'win' 
+subfolder, which would automatically keep them from being added to the Bakefiles.
+
+
+Bakefile formats
+-----------------
+
+For those of you curious about what other types of project files Bakefile can
+generate, a list can be found here: 
+
+http://bakefile.sourceforge.net/doc/html/rn01re01.html
+