Merge pull request #58 from matthetherington/update-readme

Add mention of vcredist and file system permissions to readme

README.md

@@ -1,11 +1,17 @@
-This is a C# wrapper (using P/Invoke) for the excelent Html to PDF conversion library wkhtmltopdf.
+This is a C# wrapper (using P/Invoke) for the excellent Html to PDF conversion library wkhtmltopdf.
 
 [![Build status](https://ci.appveyor.com/api/projects/status/4ble2cr9whmnrn9v/branch/master?svg=true)](https://ci.appveyor.com/project/pruiz/wkhtmltoxsharp/branch/master)
 
+PREREQUISITES
+-------------
+
+The embedded [wkhtmltopdf project](https://wkhtmltopdf.org/) project requires Visual C++ 2015 Redistributable (x86) to be installed on the machine at runtime.
+You can grab it [here](https://www.microsoft.com/en-us/download/details.aspx?id=52685) from the Microsoft website.
+
 CURRENT STATUS & LIMITATIONS
 ----------------------------
 
-I've been using it on production since Q4/2010, and has worked fine so far, so we might say it's almost 'production ready'..
+I've been using it in production since Q4/2010, and it has worked fine so far, so we might say it's almost 'production ready'..
 
 The way I'm using the component is from a back office windows service which handles html->pdf conversion as part of some workflows initiated by users from a web application, so, the web application does not directly call WkHtmlToXSharp, but instead sends a message thru NServiceBus to an independent service which handles (among other tasks) generation of a PDF
 from Html, a Pdf document which it's later made available to our user thru the web application..
@@ -18,7 +24,7 @@ As I said, it is working quite nicely, however, I think I should advise you abou
 
  * **No html to image conversions yet**: Currently the API only supports Html->Pdf conversions, although wkhtmltox.dll supports html->image too.. While implementing WkHtmlToImage should be pretty easy, it's still on TODO due to time constraints.
 
- * **No 64bits on windows**: No native 64bit windows dll is available from  upstream project (code.google.com/p/wkhtmltopdf) is not available, and even I tried and built it by myself, the produced component worked pretty flawlessly, probably due to limitations on current gnu toolchain (or even qt) on windows 64.. so all this means there's no support for running on 64bit-only .Net environments.
+ * **No 64bits on windows**: No native 64bit windows dll is available from the [wkhtmltopdf project](https://wkhtmltopdf.org/), and even I tried and built it by myself, the produced component worked pretty flawlessly, probably due to limitations on current gnu toolchain (or even qt) on windows 64.. so all this means there's no support for running on 64bit-only .Net environments.
 
    Currently there are two possible workarounds: 
 
@@ -30,8 +36,6 @@ As I said, it is working quite nicely, however, I think I should advise you abou
 
 As a final note, I should note that when using this component there's no need to download nor install wkhtmltox.dll, as native .dll/.so files needed are embedded into WkHtmlToXSharp.dll and they are deployed automatically the first time a conversion is performed.
 
-This makes the dll bigger (even if native dll's are embedded as gzipped resources), but this makes things much more fun & easier.. ;)
-
-* **No ASP.NET/IIS Support**: This has to do with the way IIS manages underlaying threads, and application pools.  IIS instantiates & re-cycles pools and AppDomains from time to time, and this causes non-managed resources used by this library to not be released properly.
-
+This makes the dll bigger (even if native dll's are embedded as gzipped resources), but this makes things much more fun & easier.. ;) As the embedded dll is written to disk, your project will need write permissions to the directory it's installed in.
 
+ * **No ASP.NET/IIS Support**: This has to do with the way IIS manages underlaying threads, and application pools.  IIS instantiates & re-cycles pools and AppDomains from time to time, and this causes non-managed resources used by this library to not be released properly.