Replace package README with README.md, rewrite content

4 files changed, 14 insertions, 31 deletions

diff --git a/xsd/README b/xsd/README
deleted file mode 100644
index dc1d4db..0000000
--- a/xsd/README
+++ /dev/null
@@ -1,29 +0,0 @@
-CodeSynthesis XSD is a W3C XML Schema to C++ data binding compiler.
-It generates vocabulary-specific, statically-typed C++ mappings (also
-called bindings) from XML Schema definitions. XSD supports two C++
-mappings: in-memory C++/Tree and event-driven C++/Parser.
-
-The C++/Tree mapping consists of types that represent the given
-vocabulary, a set of parsing functions that convert XML instance
-documents to a tree-like in-memory object model, and a set of
-serialization functions that convert the object model back to XML.
-
-The C++/Parser mapping provides parser templates for data types
-defined in XML Schema. Using these parser templates you can build
-your own in-memory representations or perform immediate processing
-of XML instance documents.
-
-Note also that the xsd executable provides build2 metadata.
-
-See the NEWS file for the user-visible changes from the previous release.
-
-See the LICENSE file for distribution conditions.
-
-See the INSTALL file for prerequisites and installation instructions.
-
-See the doc/ directory for documentation.
-
-The project page is at https://www.codesynthesis.com/projects/xsd/.
-
-Send bug reports or any other feedback to the xsd-users@codesynthesis.com
-mailing list.
diff --git a/xsd/README.md b/xsd/README.md
new file mode 100644
index 0000000..e2b2887
--- /dev/null
+++ b/xsd/README.md
@@ -0,0 +1,12 @@
+# xsd - XML Schema to C++ data binding compiler
+
+XSD is an open-source, cross-platform XML Schema to C++ data binding
+compiler. Provided with an XML document specification (XML Schema), it
+generates C++ classes that represent the given vocabulary as well as XML
+parsing and serialization code. You can then access the data stored in XML
+using types and functions that semantically correspond to your application
+domain rather than dealing with generic elements/attributes and raw strings.
+
+For further information, including licensing conditions, documentation, and
+binary packages, refer to the [XSD project
+page](https://codesynthesis.com/products/xsd/).
diff --git a/xsd/buildfile b/xsd/buildfile
index 2550da0..b0121dd 100644
--- a/xsd/buildfile
+++ b/xsd/buildfile
@@ -2,7 +2,7 @@
 # license   : GNU GPL v2 + exceptions; see accompanying LICENSE file
 
 ./: {*/ -build/} \
-    doc{README PACKAGE-README.md NEWS} \
+    doc{README.md PACKAGE-README.md NEWS} \
     legal{GPLv2 LICENSE FLOSSE} \
     manifest
 
diff --git a/xsd/manifest b/xsd/manifest
index c7a1a76..34259ab 100644
--- a/xsd/manifest
+++ b/xsd/manifest
@@ -5,7 +5,7 @@ language: c++
 summary: XML Schema to C++ data binding compiler
 license: other: GPL-2.0-only with Xerces-C++ linking exception and FLOSS exception
 topics: C++, XML, XML Schema, XML parser, source code generation
-description-file: README
+description-file: README.md
 package-description-file: PACKAGE-README.md
 changes-file: NEWS
 url: https://www.codesynthesis.com/projects/xsd/