Implement option class inheritance

For now multiple, non-virtual inheritance is supported. An option class
can now also be declared abstract using the class c = 0 {...}; syntax.
New option, --exclude-base, controls whether base class information is
present in usage and documentation.

4 files changed, 142 insertions, 0 deletions

diff --git a/tests/inheritance/driver.cxx b/tests/inheritance/driver.cxx
new file mode 100644
index 0000000..1c4d32c
--- /dev/null
+++ b/tests/inheritance/driver.cxx
@@ -0,0 +1,36 @@
+// file      : tests/inheritance/driver.cxx
+// author    : Boris Kolpackov <boris@codesynthesis.com>
+// copyright : Copyright (c) 2009-2011 Code Synthesis Tools CC
+// license   : MIT; see accompanying LICENSE file
+
+// Test option class inheritance.
+//
+
+#include <string>
+#include <cassert>
+#include <iostream>
+
+#include "test.hxx"
+
+using namespace std;
+
+int
+main (int argc, char* argv[])
+{
+  const cli::options& d (options::description ());
+
+  assert (d.size () == 4);
+  assert (d[0].name () == "--very-long-flag");
+  assert (d[1].name () == "-i");
+  assert (d[2].name () == "-s");
+  assert (d[3].name () == "--string");
+
+  options o (argc, argv);
+
+  assert (o.very_long_flag ());
+  assert (o.s () == "short");
+  assert (o.i () == 123);
+  assert (o.string () == "long");
+
+  options::print_usage (cout);
+}
diff --git a/tests/inheritance/makefile b/tests/inheritance/makefile
new file mode 100644
index 0000000..3d99a99
--- /dev/null
+++ b/tests/inheritance/makefile
@@ -0,0 +1,76 @@
+# file      : tests/inheritance/makefile
+# author    : Boris Kolpackov <boris@codesynthesis.com>
+# copyright : Copyright (c) 2009-2011 Code Synthesis Tools CC
+# license   : MIT; see accompanying LICENSE file
+
+include $(dir $(lastword $(MAKEFILE_LIST)))../../build/bootstrap.make
+
+cxx_tun := driver.cxx
+cli_tun := test.cli
+
+#
+#
+cxx_obj  := $(addprefix $(out_base)/,$(cxx_tun:.cxx=.o) $(cli_tun:.cli=.o))
+cxx_od   := $(cxx_obj:.o=.o.d)
+
+driver   := $(out_base)/driver
+test     := $(out_base)/.test
+clean    := $(out_base)/.clean
+
+# Build.
+#
+$(driver): $(cxx_obj)
+$(cxx_obj) $(cxx_od): cpp_options := -I$(out_base)
+
+genf := $(cli_tun:.cli=.hxx) $(cli_tun:.cli=.ixx) $(cli_tun:.cli=.cxx)
+gen  := $(addprefix $(out_base)/,$(genf))
+
+$(gen): $(out_root)/cli/cli
+$(gen): cli := $(out_root)/cli/cli
+$(gen): cli_options := --generate-description --option-length 17
+
+$(call include-dep,$(cxx_od),$(cxx_obj),$(gen))
+
+# Alias for default target.
+#
+$(out_base)/: $(driver)
+
+# Test.
+#
+$(test): driver := $(driver)
+$(test): $(driver) $(src_base)/test.std
+	$(call message,test $$1,$$1 --very-long-flag -s short -i 123 \
+--string long >$(out_base)/test.out,$(driver))
+	$(call message,,diff -u $(src_base)/test.std $(out_base)/test.out)
+	$(call message,,rm -f $(out_base)/test.out)
+
+# Clean.
+#
+$(clean):                            \
+  $(driver).o.clean                  \
+  $(addsuffix .cxx.clean,$(cxx_obj)) \
+  $(addsuffix .cxx.clean,$(cxx_od))  \
+  $(addprefix $(out_base)/,$(cli_tun:.cli=.cxx.cli.clean))
+
+# Generated .gitignore.
+#
+ifeq ($(out_base),$(src_base))
+$(driver): | $(out_base)/.gitignore
+
+$(out_base)/.gitignore: files := driver $(genf)
+$(clean): $(out_base)/.gitignore.clean
+
+$(call include,$(bld_root)/git/gitignore.make)
+endif
+
+# How to.
+#
+$(call include,$(bld_root)/cxx/o-e.make)
+$(call include,$(bld_root)/cxx/cxx-o.make)
+$(call include,$(bld_root)/cxx/cxx-d.make)
+$(call include,$(scf_root)/cli/cli-cxx.make)
+
+# Dependencies.
+#
+$(call import,$(src_root)/cli/makefile)
+
diff --git a/tests/inheritance/test.cli b/tests/inheritance/test.cli
new file mode 100644
index 0000000..481a771
--- /dev/null
+++ b/tests/inheritance/test.cli
@@ -0,0 +1,26 @@
+// file      : tests/inheritance/test.cli
+// author    : Boris Kolpackov <boris@codesynthesis.com>
+// copyright : Copyright (c) 2009-2011 Code Synthesis Tools CC
+// license   : MIT; see accompanying LICENSE file
+
+include <string>;
+
+class base1 = 0
+{
+  bool --very-long-flag {"Long flag."};
+};
+
+class base2
+{
+  std::string -s {"<str>", "Short string."};
+};
+
+class interm: base1
+{
+  int -i = 1 {"<num>", "Integer."};
+};
+
+class options: interm, base2
+{
+  std::string --string {"<str>", "Long string."};
+};
diff --git a/tests/inheritance/test.std b/tests/inheritance/test.std
new file mode 100644
index 0000000..4c93225
--- /dev/null
+++ b/tests/inheritance/test.std
@@ -0,0 +1,4 @@
+--very-long-flag  Long flag.
+-i <num>          Integer.
+-s <str>          Short string.
+--string <str>    Long string.