WIP: Migrate Wiki content over to src/docs

docs/using_git_submodules.md

+# 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",
+  }
+]
+```