summaryrefslogtreecommitdiff
path: root/PACKAGE-README.md
diff options
context:
space:
mode:
authorJörg Frings-Fürst <debian@jff.email>2025-03-19 15:41:36 +0100
committerJörg Frings-Fürst <debian@jff.email>2025-03-19 15:41:36 +0100
commit018e1ba581ec6f01f069a45ec4cf89f152b44d5f (patch)
tree0e7dda4bb693a6714066fbe5efcd2f24ff7c1a65 /PACKAGE-README.md
parent1c188393cd2e271ed2581471b601fb5960777fd8 (diff)
remerge
Diffstat (limited to 'PACKAGE-README.md')
-rw-r--r--PACKAGE-README.md66
1 files changed, 0 insertions, 66 deletions
diff --git a/PACKAGE-README.md b/PACKAGE-README.md
deleted file mode 100644
index 4a1ce70..0000000
--- a/PACKAGE-README.md
+++ /dev/null
@@ -1,66 +0,0 @@
-# XSD
-
-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, refer to the [XSD project
-page](https://codesynthesis.com/products/xsd/).
-
-## Usage
-
-XSD consists of several packages with the main ones being `xsd` (the XML
-Schema to C++ compiler) and `libxsd` (the runtime library). There are also
-several `*-tests` packages as well as `xsd-examples`.
-
-When specifying dependencies on XSD packages in your project, the `xsd`
-package should be a build-time dependency. The `libxsd` library is
-header-only and because it can be used either with Xerces-C++ or
-Expat as the underlying XML parser, it does not have a dependency on
-either, expecting your project to make the choice by depending on
-one or the other explicitly and then importing and linking the
-corresponding library.
-
-So, putting it all together, your project's `manifest` would normally
-have the following fragment if using Xerces-C++:
-
-```
-depends: * xsd ^4.2.0
-depends: libxsd ^4.2.0
-depends libxerces-c ^3.2.4
-```
-
-Or the following fragment if using Expat:
-
-```
-depends: * xsd ^4.2.0
-depends: libxsd ^4.2.0
-depends libexpat ^2.5.0
-```
-
-Then your `buildfile` would have something along these lines if using
-Xerces-C++:
-
-```
-import! [metadata] xsd = xsd%exe{xsd}
-
-import libs = libxsd%lib{xsd}
-import libs += libxerces-c%lib{xerces-c}
-```
-
-Or along these lines if using Expat:
-
-```
-import! [metadata] xsd = xsd%exe{xsd}
-
-import libs = libxsd%lib{xsd}
-import libs += libexpat%lib{expat}
-```
-
-Note that the `xsd` executable provides `build2` metadata.
-
-The compilation of XML Schema to C++ can be implemented using ad hoc recipes
-or rules. See the `xsd-examples` package for the complete examples.