Changes between Version 2 and Version 3 of AddingFiles

Timestamp:

Feb 4, 2014 10:23:22 AM (10 years ago)

Author:

BJ Burg

Comment:

add instructions for windoze and Gmake

AddingFiles

@@ -19 +19 @@
 == Visual Studio (Windows)
 
-TODO
+Visual Studio-based builds use XML files named after the respective WebKit components. One file (e.g., `Source/WebCore/WebCore.vcxproj.filters`) describes the tree structure of the project that should be displayed in Visual Studio. The other file (e.g., `Source/WebCore/WebCOre.vcxproj`) contains the actual build rules and dependencies.
 
-== CMake (GTK, EFL)
+=== Adding a directory
+
+* Make a stub in `Project.vcxproj.filters` at the top.
+
+
+=== Adding a file
+
+ * Add a `CLInclude` command for a header file and `CLCompile` command for an implementation file.
+ * It's recommended that you consult a build expert for anything more complicated, such as adding a new code generator (especially if you can't run Visual Studio yourself).
+
+== CMake (EFL)
 
 Find the relevant `CMakeLists.txt` file in the project directory (WebCore, WebKit2, DumpRenderTree, etc). Then, add entries to various lists in the files depending on what is being added.
@@ -41 +51 @@
 You'll need to add a custom command, and append the generated files to `Project_SOURCES` or some other list. This adds the generated file as a build dependency, and the custom rule tells CMake how to derive the generated files. See existing files for examples.
 
+
+== GMake (GTK)
+
+Build rules and paths are in a per-project `GNUMakefile.am` file. Lists of files to build go in a per-project `GNUMakefile.list.am`.
+
+=== Adding a directory
+
+ * If the directory contains headers, add it to `project_cppflags`.
+ * (WebCore only) If the directory contains IDL flies, add it to `IDL_PATH` and `EXTRA_DIST`.
+
+=== Adding a file
+
+ * If it's a new Inspector domain, add it to `project_INSPECTOR_DOMAINS` in `GNUMakefile.am`.
+ * Otherwise, add it to the correct section in `GNUMakefile.list.am`. This includes generated sources (inside `DerivedSources/`).
+
+
 = Tips
+
+ TODO - feel free to add your hard-won lessons here.