[msitools: 1/5] README->README.md

[Marc-André Lureau <malureau src gnome org>]

commit f88aaefbebb491695c5740a0e3fa5a9b34157a90
Author: Marc-André Lureau <marcandre lureau redhat com>
Date:   Tue Aug 6 15:18:43 2019 +0400

    README->README.md

 README    | 43 -------------------------------------------
 README.md | 50 ++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 50 insertions(+), 43 deletions(-)
---
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..a941821
--- /dev/null
+++ b/README.md
@@ -0,0 +1,50 @@
+# msitools
+
+## Introduction
+
+*msitools* is a set of programs to inspect and build Windows Installer
+(.MSI) files.  It is based on `libmsi`, a portable library to read and
+write .MSI files.  libmsi in turn is a port of (and a subset of)
+[Wine](https://www.winehq.org/)'s implementation of the Windows
+Installer.
+
+*msitools* plans to be a solution for packaging and deployment of
+cross-compiled Windows applications.
+
+## Tools
+
+Provided tools include:
+
+- `msiinfo`, to inspect MSI files
+
+- `msibuild`, a low-level tool to create MSI files
+
+- `msidiff`, compares contents of two MSI files with diff
+
+- `msidump`, dumps raw MSI tables and stream content
+
+- `msiextract`, to inspect and extract the files of an MSI file
+
+- `wixl`, a WiX-like tool, that builds Windows Installer (MSI)
+  packages from an XML document, and tries to share the same syntax as
+  the [WiX toolset](http://wixtoolset.org/)
+
+- `wixl-heat`, a tool that builds XML fragments from a list of files
+  and directories.
+
+
+## Notes
+
+Right now, *msitools* does not work under Windows.  It is planned that
+it will self-host.
+
+While in a very early stage, it is already usable.
+
+*msitools* uses [libgsf](https://gitlab.gnome.org/GNOME/libgsf) in
+order to read OLE Structured Storage files (which are the underlying
+format of .MSI files).
+
+Wixl lacks many features compared to WiX. As always, contributions
+are welcome!
+
+Reporting issues and sending pull requests is welcome!