From 7634fc4ea9537d60fdf686f43a4e54e7ab0f43fe Mon Sep 17 00:00:00 2001
From: a3d4 <a3d4@pm.me>
Date: Fri, 4 Feb 2022 17:54:21 +0100
Subject: [PATCH] Clarify symlink handling on Windows

---
 docs/contributing.rst    | 7 +++++++
 test/FilesystemUtils.cpp | 1 +
 2 files changed, 8 insertions(+)

diff --git a/docs/contributing.rst b/docs/contributing.rst
index 2895744ef..ba5a0a0f8 100644
--- a/docs/contributing.rst
+++ b/docs/contributing.rst
@@ -94,6 +94,13 @@ dependencies (`evmone <https://github.com/ethereum/evmone/releases>`_,
 On macOS some of the testing scripts expect GNU coreutils to be installed.
 This can be easiest accomplished using Homebrew: ``brew install coreutils``.
 
+On Windows systems make sure that you have a privilege to create symlinks,
+otherwise several tests may fail.
+Administrators should have that privilege, but you may also
+`grant it to other users <https://docs.microsoft.com/en-us/windows/security/threat-protection/security-policy-settings/create-symbolic-links#policy-management>`_
+or
+`enable Developer Mode <https://docs.microsoft.com/en-us/windows/apps/get-started/enable-your-device-for-development>`_.
+
 Running the Tests
 -----------------
 
diff --git a/test/FilesystemUtils.cpp b/test/FilesystemUtils.cpp
index 0235b1147..0d1de3af9 100644
--- a/test/FilesystemUtils.cpp
+++ b/test/FilesystemUtils.cpp
@@ -81,5 +81,6 @@ bool solidity::test::createSymlinkIfSupportedByFilesystem(
 		BOOST_THROW_EXCEPTION(runtime_error(
 			"Failed to create a symbolic link: \"" + _linkName.string() + "\""
 			" -> " + _targetPath.string() + "\"."
+			" " + symlinkCreationError.message() + "."
 		));
 }