summaryrefslogtreecommitdiff
path: root/README.md
blob: 64284bb26302d4eff903e51438d05a95024c615e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
# XSD

XSD is an XML Schema to C++ compiler.

NOTE: the steps described below are more appropriate for the development of
XSD as opposed to consumption. If you just want to use XSD, see [Installing
XSD with `build2`](https://codesynthesis.com/products/xsd/doc/install-build2.xhtml)
for the step by step instructions.

The development setup for XSD uses two configurations, for example:

```
git clone .../xsd.git
cd xsd

bdep init --empty

bdep config create @host ../xsd-host --type host cc config.cxx=g++
bdep config create @target ../xsd-target cc config.cxx=g++

bdep init @host -d xsd
bdep init @target -d libxsd -d libxsd-tests -d xsd-tests -d xsd-examples

```

To generate the documentation in the `.ps` and `.pdf` formats, `html2ps` and
`ps2pdf14` programs are required (the latter is from `ghostscript`). A warning
is issued in the development mode if these programs are not available.

To test installation of the XSD compiler, create a separate target
configuration (it will automatically resolve any build-time dependencies from
`host`):

```
bdep config create @install ../xsd-install --type target cc config.cxx=g++ \
  config.install.root=/tmp/install

bdep init @install -d xsd

b install: ../xsd-install/xsd/
```