diff options
author | Karen Arutyunov <karen@codesynthesis.com> | 2020-06-06 22:42:16 +0300 |
---|---|---|
committer | Boris Kolpackov <boris@codesynthesis.com> | 2021-09-20 16:06:46 +0200 |
commit | 2181ec73117f2e18cc622ead6256c8104b631214 (patch) | |
tree | c9d1bb2a8d3140b6cc6dd162be8129f14e38a717 /README.md | |
parent | a599248e9dfab9f5d57c06bed56f75941cb00047 (diff) |
Use ad hoc recipe for parsing code and documentation generating
The overall approach is to store pre-generated bootstrap options.?xx
and cli.{1,xhtml} and automatically update them in the development
build (config.cli.develop=true). See README.md in the root of the
repository for details.
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 35 |
1 files changed, 35 insertions, 0 deletions
diff --git a/README.md b/README.md new file mode 100644 index 0000000..c2dd3ea --- /dev/null +++ b/README.md @@ -0,0 +1,35 @@ +# CLI + +CLI is a command line interface compiler for C++. + +The development setup for CLI uses two configurations, for example: + +``` +git clone .../cli.git +cd cli + +bdep init --empty + +bdep config create @host ../cli-host --type host cc config.cxx=g++ +bdep config create @target ../cli-target cc config.cxx=g++ + +bdep init @host -d cli +bdep init @target -d cli-tests -d cli-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. + +Note that the development build cannot be installed (due to the bootstrap +process; see `cli/build/root.build` for details). To test installation, a +seperate, non-development build can be created: + +``` +bdep config create @install ../cli-install --type host cc config.cxx=g++ \ + config.install.root=/tmp/install + +bdep init @install -d cli config.cli.develop=false +b install: ../cli-install/cli/ +``` |