Modify depot_tools instructions regarding %PATH%

man/src/depot_tools_tutorial.txt

 depot_tools_tutorial(7)
 =======================
 
 NAME
 ----
 depot_tools_tutorial - A tutorial introduction to the Chromium depot_tools git
 extensions.
 
 DESCRIPTION
 -----------
@@ skipping 78 matching lines @@
 ^^^^^^^
 Download the 'depot_tools'
 link:https://storage.googleapis.com/chrome-infra/depot_tools.zip[bundle] and
 extract it somewhere.
 
 [WARNING]
 *DO NOT* use drag-n-drop or copy-n-paste extract from Explorer, this will not
 extract the hidden ``.git'' folder which is necessary for 'depot_tools' to
 autoupdate itself. You can use ``Extract all...'' from the context menu though.
 
-Add 'depot_tools' to the 'end' of your PATH. Assuming you unzipped the
-bundle to `C:\workspace\depot_tools`:
+Add 'depot_tools' to the 'start' of your PATH (must be ahead of any installs of
+Python). Assuming you unzipped the bundle to `C:\workspace\depot_tools`:
 
 With Administrator access: ::
   *Control Panel -> System and Security -> System -> Advanced system settings*
 +
 Modify the PATH system variable to include `C:\workspace\depot_tools`.
 
 Without Administrator access: ::
   *Control Panel -> User Accounts -> User Accounts -> Change my environment variables*
 +
-Add a PATH user variable: `%PATH%;C:\workspace\depot_tools`.
+Add a PATH user variable: `C:\workspace\depot_tools;%PATH%`.
 
 From a `cmd.exe` shell, run the command `gclient` (without arguments). On first
 run, gclient will install all the Windows-specific bits needed to work with the
 code, including msysgit and python.
 
 [NOTE]
 =====
 * If you run gclient from a non-cmd shell (e.g., cygwin, PowerShell), it
   may appear to run properly, but msysgit, python, and other tools may not get
   installed correctly.
 * If you see strange errors with the file system on the first run of gclient,
   you may want to link:http://tortoisesvn.tigris.org/faq.html#cantmove2[disable
   Windows Indexing].
-* If you are running Windows XP and see errors like ``The system cannot execute
-  the specified program'', try installing the
-  link:http://code.google.com/p/chromium/issues/detail?id=75886[``Microsoft
-  Visual C++ 2008 Redistributable Package''].
+* After running gclient open a command prompt and type `where python` and confirm that
+  the depot_tools python.bat comes ahead of any copies of python.exe. Failing to ensure
+  this can lead to overbuilding when using gn - see
+  link:https://bugs.chromium.org/p/chromium/issues/detail?id=611087[crbug.com/611087].
 =====
 endif::backend-xhtml11[]
 
 BOOTSTRAPPING CONFIGURATION
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 If you have never used git before, you’ll need to set some global git
 configurations; substitute your name and email address in the following
 commands:
 
 [subs="quotes,attributes"]
@@ skipping 285 matching lines @@
   dependencies to pull in. This file also contains 'hooks'.
 
 LKGR::
   Last Known Good Revision. This is a linkgit:git-tag[1] which tracks the last
   version of `origin/master` which has passed the full set of testing on the
   link:http://build.chromium.org[main Chromium waterfall].
 
 include::_footer.txt[]
 
 // vim: ft=asciidoc: