summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md36
1 files changed, 36 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..03e9d19
--- /dev/null
+++ b/README.md
@@ -0,0 +1,36 @@
+# 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.
+
+To test installation of the CLI compiler, create a separate target
+configuration (we must use a non-development build due to the bootstrap
+process):
+
+```
+bdep config create @install ../cli-install --type target cc config.cxx=g++ \
+ config.install.root=/tmp/install
+
+bdep init @install -d cli config.cli.develop=false
+
+b install: ../cli-install/cli/
+```