From 2fca545cbfaa05f5b468a36e58523fdf6cb9835c Mon Sep 17 00:00:00 2001
From: Jan Tattermusch <jtattermusch@google.com>
Date: Thu, 21 May 2015 17:46:27 -0700
Subject: [PATCH] update C# readme

---
 csharp/README.md | 44 ++++++++++++++++++++++++++++----------------
 1 file changed, 28 insertions(+), 16 deletions(-)

diff --git a/csharp/README.md b/csharp/README.md
index 438bdff152f..77d1aaf2e66 100644
--- a/csharp/README.md
+++ b/csharp/README.md
@@ -8,47 +8,59 @@ Example projects depend on NuGet packages `Grpc` and `Google.ProtocolBuffers` wh
 
 PREREQUISITES
 -------------
-Windows
+**Windows**
 - .NET 4.5+
 - VS 2013 (with NuGet plugin installed)
 
-Linux (Mono)
-- Mono installed
+**Linux (Mono)**
+- Mono
 - Monodevelop 5.9 with NuGet Add-in installed (older versions might work)
 
-MacOS (Mono)
-- TODO: MacOS support in progress
+**MacOS (Mono)**
 - Xamarin Studio (with NuGet plugin installed)
 
 BUILD
 -------
 
-Windows
+**Windows**
 - Clone this repository.
+
 - Open solution `Greeter.sln` with Visual Studio
+
 - Build the solution (this will automatically download NuGet dependencies)
 
-Linux (Mono)
+**Linux (Mono)**
 - Clone this repository.
+
 - Install gRPC C Core using instructions in https://github.com/grpc/homebrew-grpc
-- TODO: explain using LD_LIBRARY_PATH or installation to /usr/local
+
+- gRPC C# depends on native shared library `libgrpc_csharp_ext.so`. To make it visible
+  to Mono runtime, follow instructions in [Using gRPC C# on Linux](https://github.com/grpc/grpc/tree/master/src/csharp#usage-linux-mono)
+
 - Open solution `Greeter.sln` in MonoDevelop (you need to manually restore dependencies by using `mono nuget.exe restore` if you don't have NuGet add-in)
+
 - Build the solution.
 
+**MacOS (Mono)**
+- See [Using gRPC C# on MacOS](https://github.com/grpc/grpc/tree/master/src/csharp#usage-macos-mono) for more info
+  on MacOS support.
+
 Try it! 
 -------
 
 - Run the server
-```
-> cd GreeterServer/bin/Debug
-> GreeterServer.exe
-```
+
+  ```
+  > cd GreeterServer/bin/Debug
+  > GreeterServer.exe
+  ```
 
 - Run the client
-```
-> cd GreeterClient/bin/Debug
-> GreeterClient.exe
-```
+
+  ```
+  > cd GreeterClient/bin/Debug
+  > GreeterClient.exe
+  ```
 
 You can also run the server and client directly from Visual Studio.