Skip to content

Commit fc736ec

Browse files
committed
[FAB-5280] Fix git clone fabric-samples for Windows
This change expands the prerequisites documentation for Windows to instruct users on setting git properly to ensure it handles long filenames (required to successfully clone fabric-samples) and end-of-lines (required for vagrant to work). Change-Id: I8230f1980fedfb43d6e9cda8d2a2b4a65aa2434a Signed-off-by: Arnaud J Le Hors <[email protected]>
1 parent f56a82e commit fc736ec

File tree

1 file changed

+16
-0
lines changed

1 file changed

+16
-0
lines changed

docs/source/prereqs.rst

+16
Original file line numberDiff line numberDiff line change
@@ -108,6 +108,22 @@ provides a better alternative to the built-in Windows tools:
108108
:doc:`getting_started`, but you may not be able to find a
109109
suitable ``make`` command.
110110

111+
Before running any ``git clone`` commands, run the following commands:
112+
113+
::
114+
115+
git config --global core.autocrlf false
116+
git config --global core.longpaths true
117+
118+
You can check the setting of these parameters with the following commands:
119+
120+
::
121+
122+
git config --get core.autocrlf
123+
git config --get core.longpaths
124+
125+
These need to be ``false`` and ``true`` respectively.
126+
111127
.. note:: The ``curl`` command that comes with Git and Docker Toolbox
112128
is old and does not handle properly the redirect used in
113129
:doc:`getting_started`. Make sure you install and use a

0 commit comments

Comments
 (0)