Skip to content
C-family Abstract Syntax Tree XML Output
C++ CMake C Shell
Branch: master
Clone or download

README.rst

CastXML

Introduction

CastXML is a C-family abstract syntax tree XML output tool.

This project is maintained by Kitware in support of ITK, the Insight Segmentation and Registration Toolkit.

Manual

See the castxml(1) manual page for instructions to run the tool.

License

CastXML is licensed under the Apache License, Version 2.0. See the LICENSE and NOTICE files for details.

Community

Subscribe and post to the CastXML Mailing List for discussion of CastXML.

Build

To build CastXML from source, first obtain the prerequisites:

  • A C++ compiler supporting the c++11 standard language level.
  • CMake cross-platform build system generator.
  • LLVM/Clang compiler SDK install tree built using the C++ compiler. This version of CastXML has been tested with LLVM/Clang
    • Git master as of 2020-02-13 (6c73246179)
    • Release 10.0
    • Release 9.0
    • Release 8.0
    • Release 7.0
    • Release 6.0
    • Release 5.0
    • Release 4.0
    • Release 3.9
    • Release 3.8
    • Release 3.7
    • Release 3.6
  • Optionally, the Sphinx documentation generator to build documentation.

Run CMake on the CastXML source tree to generate a build tree using a C++ compiler compatible with that used to build the LLVM/Clang SDK. CMake options include:

Clang_DIR
Location of the LLVM/Clang SDK. Set to <prefix>/lib/cmake/clang, where <prefix> is the top of the LLVM/Clang SDK install tree. Alternatively, LLVM_DIR may be set to <prefix>/lib/cmake/llvm.
SPHINX_EXECUTABLE
Location of the sphinx-build executable. Required only if building documentation.
SPHINX_HTML
Build documentation in html format.
SPHINX_MAN
Build documentation in man format.

Run the corresponding native build tool (e.g. make) in the CastXML build tree, and optionally build the install target. The castxml command-line tool may be used either from the build tree or the install tree. The install tree is relocatable.

You can’t perform that action at this time.