Index: docs/using_git_submodules.md |
diff --git a/docs/using_git_submodules.md b/docs/using_git_submodules.md |
new file mode 100644 |
index 0000000000000000000000000000000000000000..e1f568cbb226923002a9154895f989cf51e04d9a |
--- /dev/null |
+++ b/docs/using_git_submodules.md |
@@ -0,0 +1,101 @@ |
+# AS OF 2014-05-08 SUBMODULES HAVE BEEN REMOVED AND ARE NO LONGER OPERATIVE |
Bons
2015/08/20 20:16:51
remove
|
+ |
+Follow the instructions in http://dev.chromium.org/developers/how-tos/get-the-code instead and use fetch :). |
+ |
+## Convert from submodules to gclient |
+ |
+You do **not** need to delete your existing submodule-based checkout. |
+ |
+**If you are a Google employee and your checkout has Google-internal code**, please look for instructions on the internal wiki. |
+ |
+To start using gclient, you simply need to create a `.gclient` file at the top-level of your checkout (in the directory containing `src/`). Here are some sample `.gclient` files for common work flows: |
+ |
+### Desktop chromium browser development |
+ |
+This is the most common variant. |
+ |
+``` |
+solutions=[ |
+ { |
+ "name": "src", |
+ "url": "https://chromium.googlesource.com/chromium/src.git", |
+ "managed": False, |
+ "deps_file": ".DEPS.git", |
+ } |
+] |
+``` |
+ |
+### Blink development |
+ |
+Just like basic chromium development, except that the blink checkout floats to tip-of-tree, rather than being pinned to the version in `src/DEPS`. |
+ |
+``` |
+solutions = [ |
+ { |
+ "name": "src", |
+ "url": "https://chromium.googlesource.com/chromium/src.git", |
+ "managed": False, |
+ "deps_file": ".DEPS.git", |
+ "custom_vars": { |
+ "webkit_rev": "" |
+ } |
+ } |
+] |
+``` |
+ |
+### Chromium for Android |
+ |
+``` |
+solutions = [ |
+ { |
+ "name": "src", |
+ "url": "https://chromium.googlesource.com/chromium/src.git", |
+ "managed": False, |
+ "deps_file": ".DEPS.git", |
+ } |
+] |
+ |
+target_os = ["android"] |
+``` |
+ |
+### Chromium for iOS |
+ |
+``` |
+solutions = [ |
+ { |
+ "name": "src", |
+ "url": "https://chromium.googlesource.com/chromium/src.git", |
+ "managed": False, |
+ "deps_file": ".DEPS.git", |
+ } |
+] |
+ |
+target_os = ["ios"] |
+target_os_only = True |
+``` |
+ |
+### Native Client |
+ |
+``` |
+solutions = [ |
+ { |
+ "name": "native_client", |
+ "url": "https://chromium.googlesource.com/native_client/src/native_client.git", |
+ "managed": False, |
+ "deps_file": ".DEPS.git", |
+ } |
+] |
+``` |
+ |
+### Native Client Ports |
+ |
+``` |
+solutions = [ |
+ { |
+ "name": "src", |
+ "url": "https://chromium.googlesource.com/external/naclports.git", |
+ "managed": False, |
+ "deps_file": ".DEPS.git", |
+ } |
+] |
+``` |