Skip to content

Commit d51d91e

Browse files
committed
Document Windows permission matters
1 parent 81b0559 commit d51d91e

File tree

1 file changed

+14
-0
lines changed

1 file changed

+14
-0
lines changed

doc/commands/setup_command.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -94,3 +94,17 @@ and the command are inconsistent and take no action.
9494
* the `tinfo6` and `tinfo6-libc6-pre232` builds with the 'Fedora 27' binary
9595
distribution of GHC 9.4.4 to 9.4.8. Those binary distributions require
9696
versions of `libc6` that are compatible with `libc6` 2.26.
97+
98+
=== "Windows"
99+
100+
Since Windows 10 version 1607, Windows has been 'long file paths' capable
101+
but that capability is not enabled by default. Consequently, Stack does not
102+
assume that it is being used on a system that is 'long file paths' enabled.
103+
104+
Stack uses the 7-Zip tool to decompress, and extract tools from, downloaded
105+
archive files. Aiming to avoid long file paths, Stack does so in a temporary
106+
directory (named `stack-tmp-<hash>`) in the root of the drive of the final
107+
destination. Consequently, Stack needs permission to create a directory in
108+
that location. A Windows user account of type Administrator will have
109+
permission to create a directory in the root of the system drive (`C:\`, by
110+
convention) but a Standard user account may well not have permission.

0 commit comments

Comments
 (0)