Documentation: Consistancy

  * Don't rely on '#!', since it doesn't work for Windows cmd shell.
  * Consistantly use `tools/git-sync-deps` rather than `bin/sync`.
  * Always call `bin/gn` ranther than `gn` in case depot_tools is
    missing from the path.

NOTRY=true
Change-Id: I27909f2610d1bb3241874399d7d2f7286f99f43b
Reviewed-on: https://skia-review.googlesource.com/9640
Reviewed-by: Mike Klein <mtklein@chromium.org>
Commit-Queue: Mike Klein <mtklein@chromium.org>

diff --git a/site/dev/chrome/repo.md b/site/dev/chrome/repo.md
index d897e1edaf401184e72b61812989f3de874f7a0a..545f154a2a089909dc85eca7ca0986f487dc8fdf 100644 (file)
--- a/site/dev/chrome/repo.md
+++ b/site/dev/chrome/repo.md
@@ -3,10 +3,8 @@ Working in a Chromium repo
 
 To work on Skia inside a Chromium checkout, run the following:
 
-~~~~
-$ cd chromium/src/third_party/skia
-$ tools/git-sync-deps
-~~~~
+    cd chromium/src/third_party/skia
+    python tools/git-sync-deps
 
 This command does a minimal "just sync the DEPS" emulation of gclient sync for
 Skia into chromium/src/third_party/skia/third_party.  After that, make dm or

diff --git a/site/dev/contrib/submit.md b/site/dev/contrib/submit.md
index a64fe87fa3f328c94d29eb0465107160b9c07b31..d3ffc9d572b1216271c3cfd6a7632088dabc1de5 100644 (file)
--- a/site/dev/contrib/submit.md
+++ b/site/dev/contrib/submit.md
@@ -32,7 +32,7 @@ If your branch gets out of date, you will need to update it:
 <!--?prettify lang=sh?-->
 
     git pull
-    python bin/sync
+    python tools/git-sync-deps
 
 Adding a unit test
 ------------------

diff --git a/site/dev/testing/testing.md b/site/dev/testing/testing.md
index 29f7a4dae05ab2af59d1a7a6c0f25a1dba296323..c14ca72f687912fa9a01f33ec231752ded0b15d9 100644 (file)
--- a/site/dev/testing/testing.md
+++ b/site/dev/testing/testing.md
@@ -6,8 +6,8 @@ This is a quickstart to building and running DM.
 
 <!--?prettify lang=sh?-->
 
-    python bin/sync
-    gn gen out/Debug
+    python tools/git-sync-deps
+    bin/gn gen out/Debug
     ninja -C out/Debug dm
     out/Debug/dm -v -w dm_output
 

diff --git a/site/dev/testing/tests.md b/site/dev/testing/tests.md
index 701c2c4dfd88431e4ff60f5a0edec3da1cdb6a00..c24a1731e07c7aba8adec96987e155f0256d987d 100644 (file)
--- a/site/dev/testing/tests.md
+++ b/site/dev/testing/tests.md
@@ -9,9 +9,9 @@ We assume you have already synced Skia's dependecies and set up Skia's build sys
 
 <!--?prettify lang=sh?-->
 
-    python bin/sync
-    gn gen out/Debug
-    gn gen out/Release --args='is_debug=false'
+    python tools/git-sync-deps
+    bin/gn gen out/Debug
+    bin/gn gen out/Release --args='is_debug=false'
 
 <span id="test"></span>
 

diff --git a/site/dev/testing/xsan.md b/site/dev/testing/xsan.md
index aec935ee8066785cfe421c536b38651dea835eea..56cc2bec7ab5c4abf289f220109655d7034d945a 100644 (file)
--- a/site/dev/testing/xsan.md
+++ b/site/dev/testing/xsan.md
@@ -8,7 +8,7 @@ Get Clang binaries
 
     CLANGDIR="${HOME}/clang"
 
-    tools/git-sync-deps
+    python tools/git-sync-deps
     CC= CXX= infra/bots/assets/clang_linux/create.py -t "$CLANGDIR"
 
 Configure and Compile Skia with MSAN
@@ -23,7 +23,7 @@ Configure and Compile Skia with MSAN
         sanitize = "MSAN"
         skia_use_fontconfig = false
     EOF
-    tools/git-sync-deps
+    python tools/git-sync-deps
     bin/gn gen out/msan
     ninja -C out/msan
 
@@ -37,7 +37,7 @@ Configure and Compile Skia with ASAN
         cxx = "${CLANGDIR}/bin/clang++"
         sanitize = "ASAN"
     EOF
-    tools/git-sync-deps
+    python tools/git-sync-deps
     bin/gn gen out/asan
     ninja -C out/asan
 
@@ -52,7 +52,7 @@ Configure and Compile Skia with TSAN
         sanitize = "TSAN"
         is_debug = false
     EOF
-    tools/git-sync-deps
+    python tools/git-sync-deps
     bin/gn gen out/tsan
     ninja -C out/tsan
 

diff --git a/site/user/sample/viewer.md b/site/user/sample/viewer.md
index d41590ad917958bb8c6812eb5579c7871f1d973f..66330ebf344dc793d81cd9bdf09505d925bbc848 100644 (file)
--- a/site/user/sample/viewer.md
+++ b/site/user/sample/viewer.md
@@ -17,7 +17,7 @@ Linux, Macintosh and Windows
 
 The Viewer can be built using the regular GN build process, e.g.
 
-    gn gen out/Release --args='is_debug=false'
+    bin/gn gen out/Release --args='is_debug=false'
     ninja -C out/Release viewer
 
 Android