0

Mention the git longpaths support for Windows

By default git is constrained to the 260-character MAX_PATH limitation
on Windows. However this limitation can be configured away with this
command:

  git config --global core.longpaths true

This is useful when cloning a repo that contains long paths, or if your
repo root has a longer path than expected.

Trivia: even with this configured the longest repo root path is around
210 characters. Any longer than that and "fatal: '$GIT_DIR' too big"
will be hit.

This issue was first hit and was initially tested with
"fetch infra_internal" but could hit elsewhere.

Testing has confirmed that this config setting lets git handle repos
and repo base paths that it otherwise fails on. Setting the
LongPathsEnabled registry key, in contrast, does not work.

Bug: 1472848
Change-Id: I20d6c1d944987ce44d6f7d5cb84a53f1162b8cf9
Reviewed-on: https://chromium-review.googlesource.com/c/chromium/src/+/5046121
Reviewed-by: Solomon Kinard <solomonkinard@chromium.org>
Commit-Queue: Bruce Dawson <brucedawson@chromium.org>
Cr-Commit-Position: refs/heads/main@{#1227793}
This commit is contained in:
Bruce Dawson
2023-11-22 04:43:15 +00:00
committed by Chromium LUCI CQ
parent 2769b34fdf
commit c2c02e5709

@ -136,6 +136,13 @@ $ git config --global core.filemode false
$ git config --global branch.autosetuprebase always
```
While not necessarily required it can be helpful to configure git to allow long
path support (beyond the Windows MAX_PATH limit):
```shell
git config --global core.longpaths true
```
Create a `chromium` directory for the checkout and change to it. You can call
this whatever you like and put it wherever you like, as long as the full path
has no spaces. However there are some performance benefits for Googlers in