Update CSharp build instructions

1 files changed, 13 insertions, 37 deletions

diff --git a/csharp/BuildInstructions.md b/csharp/BuildInstructions.md
index 5bb8b5f2dc8..c20899c84a7 100644
--- a/csharp/BuildInstructions.md
+++ b/csharp/BuildInstructions.md
@@ -11,24 +11,15 @@ for the supported platforms.
 Ice for .NET was extensively tested using the operating systems and compiler
 versions listed for our [supported platforms][2].
 
-The build requires the [Ice Builder for Visual Studio][8], you must install
-version 4.2.0 or greater to build Ice.
-
-### Slice to C# Translator
-
-You will need the Slice to C# translator. ZeroC provides translator binaries for
-our supported platforms, or you can build Ice for C++ (which contains the Slice
-to C# translator) from source.
+The build requires the [Ice Builder for Visual Studio][3], you must install
+version 4.3.6 or greater to build Ice.
 
 ## Compiling Ice for .NET with Visual Studio
 
 ### Preparing to Build
 
 The build system requires the Slice translator from Ice for C++. If you have not
-built Ice for C++ in this source distribution, you must set the `ICE_HOME`
-environment variable with the path name of your Ice installation:
-
-    > set ICE_HOME=C:\Program Files (x86)\ZeroC\Ice-3.7a3
+built Ice for C++ in this source distribution, refer to [C++ build instructions](../cpp/BuildInstructionsWindows.md)
 
 ### Building Ice for .NET
 
@@ -38,19 +29,12 @@ Open a Visual Studio command prompt and change to the `csharp` subdirectory:
 
 To build the Ice assemblies, services and tests, run
 
-    Msbuild msbuild\ice.proj
+    MSBuild msbuild\ice.proj
 
 Upon completion, the Ice assemblies are placed in the `Assemblies` subdirectory.
 
 ## Running the .NET Tests
 
-Some of the Ice for .NET tests employ applications that are part of the Ice for
-C++ distribution. If you have not built Ice for C++ in this source distribution
-then you must set the `ICE_HOME` environment variable with the path name of your
-Ice installation:
-
-    > set ICE_HOME=C:\Program Files (x86)\ZeroC\Ice-3.7a3
-
 Python is required to run the test suite. Additionally, the Glacier2 tests
 require the Python module `passlib`, which you can install with the command:
 
@@ -69,27 +53,19 @@ running this command:
 If everything worked out, you should see lots of `ok` messages. In case of a
 failure, the tests abort with `failed`.
 
-## Protocol Compression with .NET
-
-Ice for .NET attempts to dynamically load `bzip2.dll` to support protocol
-compression, therefore this DLL must be present in your PATH. Ice automatically
-disables protocol compression if the DLL cannot be found.
-
-On 64-bit Windows, you must ensure that Ice finds the 64-bit version of
-`bzip2.dll` before the 32-bit version. The 64-bit and 32-bit bzip2 libraries are
-installed in `<prefix>\bin\x64` and `<prefix>\bin`, respectively. For 64-bit
-Windows, the `<prefix>\bin\x64` directory must appear before `<prefix>\bin` in
-your application's PATH. (The Ice run time prints a warning to the console if it
-detects a `bzip2.dll` format mismatch during start-up.)
-
 ## Targeting Managed Code
 
-TODO
+Ice invokes unmanaged code to implement the following features:
+
+- Protocol compression
+- Signal processing in the Ice.Application class
 
-## Targeting Unity
+if you do not require these features and prefer that the Ice run time use only 
+managed code, you can build using the `Debug-Managed` or `Release-Manage` 
+configurations.
 
-TODO
+    MSBuild msbuild\ice.proj /p:Configuration=Release-Managed
 
 [1]: https://zeroc.com/download.html
 [2]: https://doc.zeroc.com/display/Ice37/Supported+Platforms+for+Ice+3.7.0
-[3]: https://msdn.microsoft.com/en-us/library/ms241613.aspx
+[3]: https://github.com/zeroc-ice/ice-builder-visualstudio