Add documentation and licence

docs/Home.md

@@ -0,0 +1,33 @@
+### An open source viewer for Microsoft Outlook’s .ost and .pst files, written entirely in C#
+
+**New:  Version 1.1 released as a beta.**  In version 1.0, only the properties of Messages were exposed. In version 1.1, the properties pane shows the properties of the most recently clicked Message, Recipient or Attachment..
+
+Xst Reader is an open source viewer for Microsoft Outlook’s .ost and .pst files, written entirely in C#, requiring only .Net Framework 4, and with no dependency on any Microsoft Office components.
+
+It presents as a simple, classic, three pane mail viewer:
+
+ ![](Home_screenshot0.9.jpg)
+It allows viewing of emails in plain text, HTML, and RTF formats.  Attachments are listed and can be saved as separate files.  Xst Reader will read both current 64-bit Unicode .ost and .pst files and older 32-bit ANSI formats.
+
+Xst Reader goes beyond Outlook in that it will allow you to open .ost files, which are the caches created by Outlook to hold a local copy of a mailbox. Wanting to read an .ost file was the original motivation for this project: knowing that documentation of the format existed, I thought it would only take me a couple of days. In fact, it rapidly became clear that I’d bitten into something considerably more complex than that. But once I’d started…
+
+It requires only .Net Framework 4, which is installed by default on Windows 8.1 and later, but will need to be installed on Windows 7 and earlier systems before Xst Reader can be run.  .Net Framework 4 can be downloaded from [https://www.microsoft.com/en-us/download/details.aspx?id=17851](https://www.microsoft.com/en-us/download/details.aspx?id=17851)
+
+Xst Reader is based on Microsoft’s documentation of the Outlook file formats in {"[MS-PST](MS-PST)"}, first published in 2010 as part of the anti-trust settlement with the DOJ and the EU: [https://msdn.microsoft.com/en-us/library/ff385210(v=office.12).aspx](https://msdn.microsoft.com/en-us/library/ff385210(v=office.12).aspx) 
+
+Xst Reader was created because I couldn’t find an open source .ost and .pst file reader using a modern garbage collected language and framework. Here are some other open source .ost and .pst file readers that I did find:
+
+* PST File Format SDK. An official Microsoft implementation of {"[MS-PST](MS-PST)"}, written in C++. The viewer that comes with it presents file internals rather than anything usable: [https://pstsdk.codeplex.com/](https://pstsdk.codeplex.com/)
+* pstsdk.net: .NET port of PST File Format SDK, coming out of the same team. This would have been a natural basis for my efforts, but the project seems to have stalled back in 2012: [https://pstsdknet.codeplex.com/](https://pstsdknet.codeplex.com/)
+* libpff. A library and tools for accessing .ost and .pst files, written in C. Built for forensic analysis purposes by a German company, and predating {"[MS-PST](MS-PST)"} but updated since, this is probably the most comprehensive program for extracting the contents of these files, but does not include any useful UI: [https://github.com/libyal/libpff](https://github.com/libyal/libpff)
+Another approach to accessing an .ost file is to convert it to a .pst file, so that it can be opened in Outlook.
+Xst Reader does not support this, and I know of no open source programs that do. libpff extracts the contents of emails into standard files, but there is nothing that will write emails out into another mail format. 
+
+Going beyond open source, there are quite a few companies offering commercial software which will read .ost files and convert them to .pst files. I haven’t found any that are free and catch-free, or tried any of them, and I make no recommendations. Examples are:
+* OST2 - an OST to PST converter, free if your file is connected to Outlook (probably Office dependent), purchase needed to operate standalone: [http://www.ost2.com/](http://www.ost2.com/)
+* OST to PST Converter Tool will view the contents of an .ost file for free,  but exporting files requires a licence. This is more the typical pattern: [http://www.osttopstfile.co.uk/](http://www.osttopstfile.co.uk/)
+
+
+
+
+

license.md

@@ -0,0 +1,32 @@
+Ms-PL
+Microsoft Public License (Ms-PL)
+
+This license governs use of the accompanying software. If you use the software, you accept this license. If you do not accept the license, do not use the software.
+
+1. Definitions
+
+The terms "reproduce," "reproduction," "derivative works," and "distribution" have the same meaning here as under U.S. copyright law.
+
+A "contribution" is the original software, or any additions or changes to the software.
+
+A "contributor" is any person that distributes its contribution under this license.
+
+"Licensed patents" are a contributor's patent claims that read directly on its contribution.
+
+2. Grant of Rights
+
+(A) Copyright Grant- Subject to the terms of this license, including the license conditions and limitations in section 3, each contributor grants you a non-exclusive, worldwide, royalty-free copyright license to reproduce its contribution, prepare derivative works of its contribution, and distribute its contribution or any derivative works that you create.
+
+(B) Patent Grant- Subject to the terms of this license, including the license conditions and limitations in section 3, each contributor grants you a non-exclusive, worldwide, royalty-free license under its licensed patents to make, have made, use, sell, offer for sale, import, and/or otherwise dispose of its contribution in the software or derivative works of the contribution in the software.
+
+3. Conditions and Limitations
+
+(A) No Trademark License- This license does not grant you rights to use any contributors' name, logo, or trademarks.
+
+(B) If you bring a patent claim against any contributor over patents that you claim are infringed by the software, your patent license from such contributor to the software ends automatically.
+
+(C) If you distribute any portion of the software, you must retain all copyright, patent, trademark, and attribution notices that are present in the software.
+
+(D) If you distribute any portion of the software in source code form, you may do so only under this license by including a complete copy of this license with your distribution. If you distribute any portion of the software in compiled or object code form, you may only do so under a license that complies with this license.
+
+(E) The software is licensed "as-is." You bear the risk of using it. The contributors give no express warranties, guarantees or conditions. You may have additional consumer rights under your local laws which this license cannot change. To the extent permitted under your local laws, the contributors exclude the implied warranties of merchantability, fitness for a particular purpose and non-infringement.