Add README.md

CtrlCEnabler.sln

@@ -5,6 +5,12 @@ VisualStudioVersion = 15.0.27130.2026
 MinimumVisualStudioVersion = 10.0.40219.1
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "CtrlCEnabler", "CtrlCEnabler.csproj", "{027A0D34-5D00-432C-AC73-17390F0D93C8}"
 EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "README", "README", "{D5E01393-C29E-4CE5-9943-58B1CBCBD909}"
+	ProjectSection(SolutionItems) = preProject
+		LICENSE = LICENSE
+		README.md = README.md
+	EndProjectSection
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU

README.md

@@ -0,0 +1,48 @@
+# Ctrl+C Enabler for PowerShell
+
+## Summary
+
+This is a .NET class library that allows you to enable Ctrl+C break on PowerShell console, always.
+
+## Why should be use this?
+
+In some case, a PowerShell console, which is launched from Visual Studio IDE external tools menu, doesn't accept Ctrl+C.
+
+This class library can fix it :)
+
+## How to install in your PowerShell?
+
+1. Download "CtrlCEnabler.dll" from [release page](releases), and save it into "%HOME%\Documents\WindowsPowerShell" folder.
+2. Open the PowerShell console and enter the following command:
+```powershell
+PS> notepad $PROFILE
+```
+3. Then, the file "Microsoft.PowerShell_profile.ps1" is opened in a text editor.
+4. Append lines as follows at the bottom of "Microsoft.PowerShell_profile.ps1", and save it.
+```powershell
+# Enable Ctrl+C force.
+Add-Type -Path "$env:HOME\Documents\WindowsPowerShell\CtrlCEnabler.dll"
+[CtrlCEnabler]::EnableCtrlC() > $null
+```
+
+After this instruction, the PowerShell console always enables Ctrl + C break, even when launched from Visual Studio's external tools menu.
+
+## How does it work?
+
+This class library just calls the `SetConsoleCtrlHandler` Win32 API.
+
+```csharp
+public static bool EnableCtrlC()
+{
+    return SetConsoleCtrlHandler(null, false);
+}
+```
+
+See also:
+
+- https://docs.microsoft.com/en-us/windows/console/ctrl-c-and-ctrl-break-signals
+- https://docs.microsoft.com/en-us/windows/console/setconsolectrlhandler
+
+## LICENSE
+
+[The Unlicense](LICENSE)