Skip to content

Commit 7b65cf2

Browse files
committed
docs/config-prereqs.txt: update MSYS2 chapter with notes on symlink enablement
Signed-off-by: Jim Klimov <jimklimov+nut@gmail.com>
1 parent 7de1200 commit 7b65cf2

File tree

2 files changed

+21
-1
lines changed

2 files changed

+21
-1
lines changed

docs/config-prereqs.txt

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1970,6 +1970,22 @@ Finally, install tools and prerequisites for building NUT; note that some
19701970
of the recommended package names are "umbrellas" for several implementations,
19711971
and the `pacman` would ask you which (or "all") to install in those cases.
19721972

1973+
NUT build recipes and other scripts use symbolic links generously.
1974+
Creation of these requires not only the use of NTFS, but also a granted
1975+
run-time user privilege on Windows, as well as a setting for MSYS/CygWin
1976+
`ln` implementation to actually create symlinks and not copy the files.
1977+
Add this to your `~/.profile` in the MSYS2 environment, and change your
1978+
account accordingly (or modify the MSYS2 shortcut to always "Run as
1979+
Administrator" and ask for UAC upon launch as needed):
1980+
1981+
----
1982+
### This may require elevated privileges (Run as Administrator),
1983+
### or a Developer profile in Windows (can come via registry hacks),
1984+
### or a Group Policy setting:
1985+
MSYS="winsymlinks:nativestrict"
1986+
export MSYS
1987+
----
1988+
19731989
NOTE: Suggestions below use `x86_64` generic variants where possible, and
19741990
`clang` where available to try both build toolkits on the platform. If you
19751991
want to build `i686` (32-bit) or alternate backends (e.g. `ucrt` instead

docs/nut.dict

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
personal_ws-1.1 en 3721 utf-8
1+
personal_ws-1.1 en 3725 utf-8
22
AAC
33
AAS
44
ABI
@@ -836,6 +836,7 @@ NOTOTHER
836836
NOTOVER
837837
NOTTRIM
838838
NQA
839+
NTFS
839840
NTP
840841
NTU
841842
NTU's
@@ -1393,6 +1394,7 @@ TrippLite
13931394
Tru
13941395
Tx
13951396
TxD
1397+
UAC
13961398
UB
13971399
UBD
13981400
UBR
@@ -2727,6 +2729,7 @@ nano
27272729
nanosleep
27282730
nashkaminski
27292731
natively
2732+
nativestrict
27302733
nb
27312734
nbproject
27322735
nbr
@@ -3646,6 +3649,7 @@ winhid
36463649
wininit
36473650
winnutclient
36483651
winpthreads
3652+
winsymlinks
36493653
wix
36503654
wmNUT
36513655
wmnut

0 commit comments

Comments
 (0)