// -*- C++ -*-
//
// This file was generated by CLI, a command line interface
// compiler for C++.
//

// Begin prologue.
//
//
// End prologue.

#include <cli/options.hxx>

#include <map>
#include <set>
#include <string>
#include <vector>
#include <ostream>
#include <sstream>
#include <cstring>
#include <fstream>

namespace cli
{
  // unknown_option
  //
  unknown_option::
  ~unknown_option () throw ()
  {
  }

  void unknown_option::
  print (::std::ostream& os) const
  {
    os << "unknown option '" << option ().c_str () << "'";
  }

  const char* unknown_option::
  what () const throw ()
  {
    return "unknown option";
  }

  // unknown_argument
  //
  unknown_argument::
  ~unknown_argument () throw ()
  {
  }

  void unknown_argument::
  print (::std::ostream& os) const
  {
    os << "unknown argument '" << argument ().c_str () << "'";
  }

  const char* unknown_argument::
  what () const throw ()
  {
    return "unknown argument";
  }

  // missing_value
  //
  missing_value::
  ~missing_value () throw ()
  {
  }

  void missing_value::
  print (::std::ostream& os) const
  {
    os << "missing value for option '" << option ().c_str () << "'";
  }

  const char* missing_value::
  what () const throw ()
  {
    return "missing option value";
  }

  // invalid_value
  //
  invalid_value::
  ~invalid_value () throw ()
  {
  }

  void invalid_value::
  print (::std::ostream& os) const
  {
    os << "invalid value '" << value ().c_str () << "' for option '"
       << option ().c_str () << "'";

    if (!message ().empty ())
      os << ": " << message ().c_str ();
  }

  const char* invalid_value::
  what () const throw ()
  {
    return "invalid option value";
  }

  // eos_reached
  //
  void eos_reached::
  print (::std::ostream& os) const
  {
    os << what ();
  }

  const char* eos_reached::
  what () const throw ()
  {
    return "end of argument stream reached";
  }

  // file_io_failure
  //
  file_io_failure::
  ~file_io_failure () throw ()
  {
  }

  void file_io_failure::
  print (::std::ostream& os) const
  {
    os << "unable to open file '" << file ().c_str () << "' or read failure";
  }

  const char* file_io_failure::
  what () const throw ()
  {
    return "unable to open file or read failure";
  }

  // unmatched_quote
  //
  unmatched_quote::
  ~unmatched_quote () throw ()
  {
  }

  void unmatched_quote::
  print (::std::ostream& os) const
  {
    os << "unmatched quote in argument '" << argument ().c_str () << "'";
  }

  const char* unmatched_quote::
  what () const throw ()
  {
    return "unmatched quote";
  }

  // scanner
  //
  scanner::
  ~scanner ()
  {
  }

  // argv_scanner
  //
  bool argv_scanner::
  more ()
  {
    return i_ < argc_;
  }

  const char* argv_scanner::
  peek ()
  {
    if (i_ < argc_)
      return argv_[i_];
    else
      throw eos_reached ();
  }

  const char* argv_scanner::
  next ()
  {
    if (i_ < argc_)
    {
      const char* r (argv_[i_]);

      if (erase_)
      {
        for (int i (i_ + 1); i < argc_; ++i)
          argv_[i - 1] = argv_[i];

        --argc_;
        argv_[argc_] = 0;
      }
      else
        ++i_;

      return r;
    }
    else
      throw eos_reached ();
  }

  void argv_scanner::
  skip ()
  {
    if (i_ < argc_)
      ++i_;
    else
      throw eos_reached ();
  }

  // argv_file_scanner
  //
  bool argv_file_scanner::
  more ()
  {
    if (!args_.empty ())
      return true;

    while (base::more ())
    {
      // See if the next argument is the file option.
      //
      const char* a (base::peek ());
      const option_info* oi = 0;
      const char* ov = 0;

      if (!skip_)
      {
        if ((oi = find (a)) != 0)
        {
          base::next ();

          if (!base::more ())
            throw missing_value (a);

          ov = base::next ();
        }
        else if (std::strncmp (a, "-", 1) == 0)
        {
          if ((ov = std::strchr (a, '=')) != 0)
          {
            std::string o (a, 0, ov - a);
            if ((oi = find (o.c_str ())) != 0)
            {
              base::next ();
              ++ov;
            }
          }
        }
      }

      if (oi != 0)
      {
        if (oi->search_func != 0)
        {
          std::string f (oi->search_func (ov, oi->arg));

          if (!f.empty ())
            load (f);
        }
        else
          load (ov);

        if (!args_.empty ())
          return true;
      }
      else
      {
        if (!skip_)
          skip_ = (std::strcmp (a, "--") == 0);

        return true;
      }
    }

    return false;
  }

  const char* argv_file_scanner::
  peek ()
  {
    if (!more ())
      throw eos_reached ();

    return args_.empty () ? base::peek () : args_.front ().c_str ();
  }

  const char* argv_file_scanner::
  next ()
  {
    if (!more ())
      throw eos_reached ();

    if (args_.empty ())
      return base::next ();
    else
    {
      hold_[i_ == 0 ? ++i_ : --i_].swap (args_.front ());
      args_.pop_front ();
      return hold_[i_].c_str ();
    }
  }

  void argv_file_scanner::
  skip ()
  {
    if (!more ())
      throw eos_reached ();

    if (args_.empty ())
      return base::skip ();
    else
      args_.pop_front ();
  }

  const argv_file_scanner::option_info* argv_file_scanner::
  find (const char* a) const
  {
    for (std::size_t i (0); i < options_count_; ++i)
      if (std::strcmp (a, options_[i].option) == 0)
        return &options_[i];

    return 0;
  }

  void argv_file_scanner::
  load (const std::string& file)
  {
    using namespace std;

    ifstream is (file.c_str ());

    if (!is.is_open ())
      throw file_io_failure (file);

    while (!is.eof ())
    {
      string line;
      getline (is, line);

      if (is.fail () && !is.eof ())
        throw file_io_failure (file);

      string::size_type n (line.size ());

      // Trim the line from leading and trailing whitespaces.
      //
      if (n != 0)
      {
        const char* f (line.c_str ());
        const char* l (f + n);

        const char* of (f);
        while (f < l && (*f == ' ' || *f == '\t' || *f == '\r'))
          ++f;

        --l;

        const char* ol (l);
        while (l > f && (*l == ' ' || *l == '\t' || *l == '\r'))
          --l;

        if (f != of || l != ol)
          line = f <= l ? string (f, l - f + 1) : string ();
      }

      // Ignore empty lines, those that start with #.
      //
      if (line.empty () || line[0] == '#')
        continue;

      string::size_type p (string::npos);
      if (line.compare (0, 1, "-") == 0)
      {
        p = line.find (' ');

        string::size_type q (line.find ('='));
        if (q != string::npos && q < p)
          p = q;
      }

      string s1;
      if (p != string::npos)
      {
        s1.assign (line, 0, p);

        // Skip leading whitespaces in the argument.
        //
        if (line[p] == '=')
          ++p;
        else
        {
          n = line.size ();
          for (++p; p < n; ++p)
          {
            char c (line[p]);
            if (c != ' ' && c != '\t' && c != '\r')
              break;
          }
        }
      }
      else if (!skip_)
        skip_ = (line == "--");

      string s2 (line, p != string::npos ? p : 0);

      // If the string (which is an option value or argument) is
      // wrapped in quotes, remove them.
      //
      n = s2.size ();
      char cf (s2[0]), cl (s2[n - 1]);

      if (cf == '"' || cf == '\'' || cl == '"' || cl == '\'')
      {
        if (n == 1 || cf != cl)
          throw unmatched_quote (s2);

        s2 = string (s2, 1, n - 2);
      }

      if (!s1.empty ())
      {
        // See if this is another file option.
        //
        const option_info* oi;
        if (!skip_ && (oi = find (s1.c_str ())))
        {
          if (s2.empty ())
            throw missing_value (oi->option);

          if (oi->search_func != 0)
          {
            std::string f (oi->search_func (s2.c_str (), oi->arg));
            if (!f.empty ())
              load (f);
          }
          else
            load (s2);

          continue;
        }

        args_.push_back (s1);
      }

      args_.push_back (s2);
    }
  }

  template <typename X>
  struct parser
  {
    static void
    parse (X& x, bool& xs, scanner& s)
    {
      using namespace std;

      const char* o (s.next ());

      if (s.more ())
      {
        string v (s.next ());
        istringstream is (v);
        if (!(is >> x && is.peek () == istringstream::traits_type::eof ()))
          throw invalid_value (o, v);
      }
      else
        throw missing_value (o);

      xs = true;
    }
  };

  template <>
  struct parser<bool>
  {
    static void
    parse (bool& x, scanner& s)
    {
      s.next ();
      x = true;
    }
  };

  template <>
  struct parser<std::string>
  {
    static void
    parse (std::string& x, bool& xs, scanner& s)
    {
      const char* o (s.next ());

      if (s.more ())
        x = s.next ();
      else
        throw missing_value (o);

      xs = true;
    }
  };

  template <typename X>
  struct parser<std::vector<X> >
  {
    static void
    parse (std::vector<X>& c, bool& xs, scanner& s)
    {
      X x;
      bool dummy;
      parser<X>::parse (x, dummy, s);
      c.push_back (x);
      xs = true;
    }
  };

  template <typename X>
  struct parser<std::set<X> >
  {
    static void
    parse (std::set<X>& c, bool& xs, scanner& s)
    {
      X x;
      bool dummy;
      parser<X>::parse (x, dummy, s);
      c.insert (x);
      xs = true;
    }
  };

  template <typename K, typename V>
  struct parser<std::map<K, V> >
  {
    static void
    parse (std::map<K, V>& m, bool& xs, scanner& s)
    {
      const char* o (s.next ());

      if (s.more ())
      {
        std::string ov (s.next ());
        std::string::size_type p = ov.find ('=');

        K k = K ();
        V v = V ();
        std::string kstr (ov, 0, p);
        std::string vstr (ov, (p != std::string::npos ? p + 1 : ov.size ()));

        int ac (2);
        char* av[] = 
        {
          const_cast<char*> (o), 0
        };

        bool dummy;
        if (!kstr.empty ())
        {
          av[1] = const_cast<char*> (kstr.c_str ());
          argv_scanner s (0, ac, av);
          parser<K>::parse (k, dummy, s);
        }

        if (!vstr.empty ())
        {
          av[1] = const_cast<char*> (vstr.c_str ());
          argv_scanner s (0, ac, av);
          parser<V>::parse (v, dummy, s);
        }

        m[k] = v;
      }
      else
        throw missing_value (o);

      xs = true;
    }
  };

  template <typename X, typename T, T X::*M>
  void
  thunk (X& x, scanner& s)
  {
    parser<T>::parse (x.*M, s);
  }

  template <typename X, typename T, T X::*M, bool X::*S>
  void
  thunk (X& x, scanner& s)
  {
    parser<T>::parse (x.*M, x.*S, s);
  }
}

#include <map>
#include <cstring>

// options
//

options::
options ()
: help_ (),
  version_ (),
  include_path_ (),
  include_path_specified_ (false),
  output_dir_ (),
  output_dir_specified_ (false),
  std_ (cxx_version::cxx98),
  std_specified_ (false),
  generate_modifier_ (),
  generate_specifier_ (),
  generate_parse_ (),
  generate_description_ (),
  generate_file_scanner_ (),
  generate_vector_scanner_ (),
  generate_group_scanner_ (),
  suppress_inline_ (),
  suppress_cli_ (),
  cli_namespace_ ("::cli"),
  cli_namespace_specified_ (false),
  ostream_type_ ("::std::ostream"),
  ostream_type_specified_ (false),
  generate_cxx_ (),
  generate_man_ (),
  generate_html_ (),
  generate_txt_ (),
  stdout__ (),
  suppress_undocumented_ (),
  suppress_usage_ (),
  long_usage_ (),
  short_usage_ (),
  page_usage_ (),
  page_usage_specified_ (false),
  option_length_ (0),
  option_length_specified_ (false),
  ansi_color_ (),
  exclude_base_ (),
  include_base_last_ (),
  class_doc_ (),
  class_doc_specified_ (false),
  class__ (),
  class__specified_ (false),
  docvar_ (),
  docvar_specified_ (false),
  link_regex_ (),
  link_regex_specified_ (false),
  link_regex_trace_ (),
  html_heading_map_ (),
  html_heading_map_specified_ (false),
  omit_link_check_ (),
  hxx_prologue_ (),
  hxx_prologue_specified_ (false),
  ixx_prologue_ (),
  ixx_prologue_specified_ (false),
  cxx_prologue_ (),
  cxx_prologue_specified_ (false),
  man_prologue_ (),
  man_prologue_specified_ (false),
  html_prologue_ (),
  html_prologue_specified_ (false),
  txt_prologue_ (),
  txt_prologue_specified_ (false),
  hxx_epilogue_ (),
  hxx_epilogue_specified_ (false),
  ixx_epilogue_ (),
  ixx_epilogue_specified_ (false),
  cxx_epilogue_ (),
  cxx_epilogue_specified_ (false),
  man_epilogue_ (),
  man_epilogue_specified_ (false),
  html_epilogue_ (),
  html_epilogue_specified_ (false),
  txt_epilogue_ (),
  txt_epilogue_specified_ (false),
  hxx_prologue_file_ (),
  hxx_prologue_file_specified_ (false),
  ixx_prologue_file_ (),
  ixx_prologue_file_specified_ (false),
  cxx_prologue_file_ (),
  cxx_prologue_file_specified_ (false),
  man_prologue_file_ (),
  man_prologue_file_specified_ (false),
  html_prologue_file_ (),
  html_prologue_file_specified_ (false),
  txt_prologue_file_ (),
  txt_prologue_file_specified_ (false),
  hxx_epilogue_file_ (),
  hxx_epilogue_file_specified_ (false),
  ixx_epilogue_file_ (),
  ixx_epilogue_file_specified_ (false),
  cxx_epilogue_file_ (),
  cxx_epilogue_file_specified_ (false),
  man_epilogue_file_ (),
  man_epilogue_file_specified_ (false),
  html_epilogue_file_ (),
  html_epilogue_file_specified_ (false),
  txt_epilogue_file_ (),
  txt_epilogue_file_specified_ (false),
  output_prefix_ (),
  output_prefix_specified_ (false),
  output_suffix_ (),
  output_suffix_specified_ (false),
  hxx_suffix_ (".hxx"),
  hxx_suffix_specified_ (false),
  ixx_suffix_ (".ixx"),
  ixx_suffix_specified_ (false),
  cxx_suffix_ (".cxx"),
  cxx_suffix_specified_ (false),
  man_suffix_ (".1"),
  man_suffix_specified_ (false),
  html_suffix_ (".html"),
  html_suffix_specified_ (false),
  txt_suffix_ (".txt"),
  txt_suffix_specified_ (false),
  option_prefix_ ("-"),
  option_prefix_specified_ (false),
  option_separator_ ("--"),
  option_separator_specified_ (false),
  keep_separator_ (),
  no_combined_flags_ (),
  no_combined_values_ (),
  include_with_brackets_ (),
  include_prefix_ (),
  include_prefix_specified_ (false),
  guard_prefix_ (),
  guard_prefix_specified_ (false),
  reserved_name_ (),
  reserved_name_specified_ (false),
  options_file_ (),
  options_file_specified_ (false)
{
}

options::
options (int& argc,
         char** argv,
         bool erase,
         ::cli::unknown_mode opt,
         ::cli::unknown_mode arg)
: help_ (),
  version_ (),
  include_path_ (),
  include_path_specified_ (false),
  output_dir_ (),
  output_dir_specified_ (false),
  std_ (cxx_version::cxx98),
  std_specified_ (false),
  generate_modifier_ (),
  generate_specifier_ (),
  generate_parse_ (),
  generate_description_ (),
  generate_file_scanner_ (),
  generate_vector_scanner_ (),
  generate_group_scanner_ (),
  suppress_inline_ (),
  suppress_cli_ (),
  cli_namespace_ ("::cli"),
  cli_namespace_specified_ (false),
  ostream_type_ ("::std::ostream"),
  ostream_type_specified_ (false),
  generate_cxx_ (),
  generate_man_ (),
  generate_html_ (),
  generate_txt_ (),
  stdout__ (),
  suppress_undocumented_ (),
  suppress_usage_ (),
  long_usage_ (),
  short_usage_ (),
  page_usage_ (),
  page_usage_specified_ (false),
  option_length_ (0),
  option_length_specified_ (false),
  ansi_color_ (),
  exclude_base_ (),
  include_base_last_ (),
  class_doc_ (),
  class_doc_specified_ (false),
  class__ (),
  class__specified_ (false),
  docvar_ (),
  docvar_specified_ (false),
  link_regex_ (),
  link_regex_specified_ (false),
  link_regex_trace_ (),
  html_heading_map_ (),
  html_heading_map_specified_ (false),
  omit_link_check_ (),
  hxx_prologue_ (),
  hxx_prologue_specified_ (false),
  ixx_prologue_ (),
  ixx_prologue_specified_ (false),
  cxx_prologue_ (),
  cxx_prologue_specified_ (false),
  man_prologue_ (),
  man_prologue_specified_ (false),
  html_prologue_ (),
  html_prologue_specified_ (false),
  txt_prologue_ (),
  txt_prologue_specified_ (false),
  hxx_epilogue_ (),
  hxx_epilogue_specified_ (false),
  ixx_epilogue_ (),
  ixx_epilogue_specified_ (false),
  cxx_epilogue_ (),
  cxx_epilogue_specified_ (false),
  man_epilogue_ (),
  man_epilogue_specified_ (false),
  html_epilogue_ (),
  html_epilogue_specified_ (false),
  txt_epilogue_ (),
  txt_epilogue_specified_ (false),
  hxx_prologue_file_ (),
  hxx_prologue_file_specified_ (false),
  ixx_prologue_file_ (),
  ixx_prologue_file_specified_ (false),
  cxx_prologue_file_ (),
  cxx_prologue_file_specified_ (false),
  man_prologue_file_ (),
  man_prologue_file_specified_ (false),
  html_prologue_file_ (),
  html_prologue_file_specified_ (false),
  txt_prologue_file_ (),
  txt_prologue_file_specified_ (false),
  hxx_epilogue_file_ (),
  hxx_epilogue_file_specified_ (false),
  ixx_epilogue_file_ (),
  ixx_epilogue_file_specified_ (false),
  cxx_epilogue_file_ (),
  cxx_epilogue_file_specified_ (false),
  man_epilogue_file_ (),
  man_epilogue_file_specified_ (false),
  html_epilogue_file_ (),
  html_epilogue_file_specified_ (false),
  txt_epilogue_file_ (),
  txt_epilogue_file_specified_ (false),
  output_prefix_ (),
  output_prefix_specified_ (false),
  output_suffix_ (),
  output_suffix_specified_ (false),
  hxx_suffix_ (".hxx"),
  hxx_suffix_specified_ (false),
  ixx_suffix_ (".ixx"),
  ixx_suffix_specified_ (false),
  cxx_suffix_ (".cxx"),
  cxx_suffix_specified_ (false),
  man_suffix_ (".1"),
  man_suffix_specified_ (false),
  html_suffix_ (".html"),
  html_suffix_specified_ (false),
  txt_suffix_ (".txt"),
  txt_suffix_specified_ (false),
  option_prefix_ ("-"),
  option_prefix_specified_ (false),
  option_separator_ ("--"),
  option_separator_specified_ (false),
  keep_separator_ (),
  no_combined_flags_ (),
  no_combined_values_ (),
  include_with_brackets_ (),
  include_prefix_ (),
  include_prefix_specified_ (false),
  guard_prefix_ (),
  guard_prefix_specified_ (false),
  reserved_name_ (),
  reserved_name_specified_ (false),
  options_file_ (),
  options_file_specified_ (false)
{
  ::cli::argv_scanner s (argc, argv, erase);
  _parse (s, opt, arg);
}

options::
options (int start,
         int& argc,
         char** argv,
         bool erase,
         ::cli::unknown_mode opt,
         ::cli::unknown_mode arg)
: help_ (),
  version_ (),
  include_path_ (),
  include_path_specified_ (false),
  output_dir_ (),
  output_dir_specified_ (false),
  std_ (cxx_version::cxx98),
  std_specified_ (false),
  generate_modifier_ (),
  generate_specifier_ (),
  generate_parse_ (),
  generate_description_ (),
  generate_file_scanner_ (),
  generate_vector_scanner_ (),
  generate_group_scanner_ (),
  suppress_inline_ (),
  suppress_cli_ (),
  cli_namespace_ ("::cli"),
  cli_namespace_specified_ (false),
  ostream_type_ ("::std::ostream"),
  ostream_type_specified_ (false),
  generate_cxx_ (),
  generate_man_ (),
  generate_html_ (),
  generate_txt_ (),
  stdout__ (),
  suppress_undocumented_ (),
  suppress_usage_ (),
  long_usage_ (),
  short_usage_ (),
  page_usage_ (),
  page_usage_specified_ (false),
  option_length_ (0),
  option_length_specified_ (false),
  ansi_color_ (),
  exclude_base_ (),
  include_base_last_ (),
  class_doc_ (),
  class_doc_specified_ (false),
  class__ (),
  class__specified_ (false),
  docvar_ (),
  docvar_specified_ (false),
  link_regex_ (),
  link_regex_specified_ (false),
  link_regex_trace_ (),
  html_heading_map_ (),
  html_heading_map_specified_ (false),
  omit_link_check_ (),
  hxx_prologue_ (),
  hxx_prologue_specified_ (false),
  ixx_prologue_ (),
  ixx_prologue_specified_ (false),
  cxx_prologue_ (),
  cxx_prologue_specified_ (false),
  man_prologue_ (),
  man_prologue_specified_ (false),
  html_prologue_ (),
  html_prologue_specified_ (false),
  txt_prologue_ (),
  txt_prologue_specified_ (false),
  hxx_epilogue_ (),
  hxx_epilogue_specified_ (false),
  ixx_epilogue_ (),
  ixx_epilogue_specified_ (false),
  cxx_epilogue_ (),
  cxx_epilogue_specified_ (false),
  man_epilogue_ (),
  man_epilogue_specified_ (false),
  html_epilogue_ (),
  html_epilogue_specified_ (false),
  txt_epilogue_ (),
  txt_epilogue_specified_ (false),
  hxx_prologue_file_ (),
  hxx_prologue_file_specified_ (false),
  ixx_prologue_file_ (),
  ixx_prologue_file_specified_ (false),
  cxx_prologue_file_ (),
  cxx_prologue_file_specified_ (false),
  man_prologue_file_ (),
  man_prologue_file_specified_ (false),
  html_prologue_file_ (),
  html_prologue_file_specified_ (false),
  txt_prologue_file_ (),
  txt_prologue_file_specified_ (false),
  hxx_epilogue_file_ (),
  hxx_epilogue_file_specified_ (false),
  ixx_epilogue_file_ (),
  ixx_epilogue_file_specified_ (false),
  cxx_epilogue_file_ (),
  cxx_epilogue_file_specified_ (false),
  man_epilogue_file_ (),
  man_epilogue_file_specified_ (false),
  html_epilogue_file_ (),
  html_epilogue_file_specified_ (false),
  txt_epilogue_file_ (),
  txt_epilogue_file_specified_ (false),
  output_prefix_ (),
  output_prefix_specified_ (false),
  output_suffix_ (),
  output_suffix_specified_ (false),
  hxx_suffix_ (".hxx"),
  hxx_suffix_specified_ (false),
  ixx_suffix_ (".ixx"),
  ixx_suffix_specified_ (false),
  cxx_suffix_ (".cxx"),
  cxx_suffix_specified_ (false),
  man_suffix_ (".1"),
  man_suffix_specified_ (false),
  html_suffix_ (".html"),
  html_suffix_specified_ (false),
  txt_suffix_ (".txt"),
  txt_suffix_specified_ (false),
  option_prefix_ ("-"),
  option_prefix_specified_ (false),
  option_separator_ ("--"),
  option_separator_specified_ (false),
  keep_separator_ (),
  no_combined_flags_ (),
  no_combined_values_ (),
  include_with_brackets_ (),
  include_prefix_ (),
  include_prefix_specified_ (false),
  guard_prefix_ (),
  guard_prefix_specified_ (false),
  reserved_name_ (),
  reserved_name_specified_ (false),
  options_file_ (),
  options_file_specified_ (false)
{
  ::cli::argv_scanner s (start, argc, argv, erase);
  _parse (s, opt, arg);
}

options::
options (int& argc,
         char** argv,
         int& end,
         bool erase,
         ::cli::unknown_mode opt,
         ::cli::unknown_mode arg)
: help_ (),
  version_ (),
  include_path_ (),
  include_path_specified_ (false),
  output_dir_ (),
  output_dir_specified_ (false),
  std_ (cxx_version::cxx98),
  std_specified_ (false),
  generate_modifier_ (),
  generate_specifier_ (),
  generate_parse_ (),
  generate_description_ (),
  generate_file_scanner_ (),
  generate_vector_scanner_ (),
  generate_group_scanner_ (),
  suppress_inline_ (),
  suppress_cli_ (),
  cli_namespace_ ("::cli"),
  cli_namespace_specified_ (false),
  ostream_type_ ("::std::ostream"),
  ostream_type_specified_ (false),
  generate_cxx_ (),
  generate_man_ (),
  generate_html_ (),
  generate_txt_ (),
  stdout__ (),
  suppress_undocumented_ (),
  suppress_usage_ (),
  long_usage_ (),
  short_usage_ (),
  page_usage_ (),
  page_usage_specified_ (false),
  option_length_ (0),
  option_length_specified_ (false),
  ansi_color_ (),
  exclude_base_ (),
  include_base_last_ (),
  class_doc_ (),
  class_doc_specified_ (false),
  class__ (),
  class__specified_ (false),
  docvar_ (),
  docvar_specified_ (false),
  link_regex_ (),
  link_regex_specified_ (false),
  link_regex_trace_ (),
  html_heading_map_ (),
  html_heading_map_specified_ (false),
  omit_link_check_ (),
  hxx_prologue_ (),
  hxx_prologue_specified_ (false),
  ixx_prologue_ (),
  ixx_prologue_specified_ (false),
  cxx_prologue_ (),
  cxx_prologue_specified_ (false),
  man_prologue_ (),
  man_prologue_specified_ (false),
  html_prologue_ (),
  html_prologue_specified_ (false),
  txt_prologue_ (),
  txt_prologue_specified_ (false),
  hxx_epilogue_ (),
  hxx_epilogue_specified_ (false),
  ixx_epilogue_ (),
  ixx_epilogue_specified_ (false),
  cxx_epilogue_ (),
  cxx_epilogue_specified_ (false),
  man_epilogue_ (),
  man_epilogue_specified_ (false),
  html_epilogue_ (),
  html_epilogue_specified_ (false),
  txt_epilogue_ (),
  txt_epilogue_specified_ (false),
  hxx_prologue_file_ (),
  hxx_prologue_file_specified_ (false),
  ixx_prologue_file_ (),
  ixx_prologue_file_specified_ (false),
  cxx_prologue_file_ (),
  cxx_prologue_file_specified_ (false),
  man_prologue_file_ (),
  man_prologue_file_specified_ (false),
  html_prologue_file_ (),
  html_prologue_file_specified_ (false),
  txt_prologue_file_ (),
  txt_prologue_file_specified_ (false),
  hxx_epilogue_file_ (),
  hxx_epilogue_file_specified_ (false),
  ixx_epilogue_file_ (),
  ixx_epilogue_file_specified_ (false),
  cxx_epilogue_file_ (),
  cxx_epilogue_file_specified_ (false),
  man_epilogue_file_ (),
  man_epilogue_file_specified_ (false),
  html_epilogue_file_ (),
  html_epilogue_file_specified_ (false),
  txt_epilogue_file_ (),
  txt_epilogue_file_specified_ (false),
  output_prefix_ (),
  output_prefix_specified_ (false),
  output_suffix_ (),
  output_suffix_specified_ (false),
  hxx_suffix_ (".hxx"),
  hxx_suffix_specified_ (false),
  ixx_suffix_ (".ixx"),
  ixx_suffix_specified_ (false),
  cxx_suffix_ (".cxx"),
  cxx_suffix_specified_ (false),
  man_suffix_ (".1"),
  man_suffix_specified_ (false),
  html_suffix_ (".html"),
  html_suffix_specified_ (false),
  txt_suffix_ (".txt"),
  txt_suffix_specified_ (false),
  option_prefix_ ("-"),
  option_prefix_specified_ (false),
  option_separator_ ("--"),
  option_separator_specified_ (false),
  keep_separator_ (),
  no_combined_flags_ (),
  no_combined_values_ (),
  include_with_brackets_ (),
  include_prefix_ (),
  include_prefix_specified_ (false),
  guard_prefix_ (),
  guard_prefix_specified_ (false),
  reserved_name_ (),
  reserved_name_specified_ (false),
  options_file_ (),
  options_file_specified_ (false)
{
  ::cli::argv_scanner s (argc, argv, erase);
  _parse (s, opt, arg);
  end = s.end ();
}

options::
options (int start,
         int& argc,
         char** argv,
         int& end,
         bool erase,
         ::cli::unknown_mode opt,
         ::cli::unknown_mode arg)
: help_ (),
  version_ (),
  include_path_ (),
  include_path_specified_ (false),
  output_dir_ (),
  output_dir_specified_ (false),
  std_ (cxx_version::cxx98),
  std_specified_ (false),
  generate_modifier_ (),
  generate_specifier_ (),
  generate_parse_ (),
  generate_description_ (),
  generate_file_scanner_ (),
  generate_vector_scanner_ (),
  generate_group_scanner_ (),
  suppress_inline_ (),
  suppress_cli_ (),
  cli_namespace_ ("::cli"),
  cli_namespace_specified_ (false),
  ostream_type_ ("::std::ostream"),
  ostream_type_specified_ (false),
  generate_cxx_ (),
  generate_man_ (),
  generate_html_ (),
  generate_txt_ (),
  stdout__ (),
  suppress_undocumented_ (),
  suppress_usage_ (),
  long_usage_ (),
  short_usage_ (),
  page_usage_ (),
  page_usage_specified_ (false),
  option_length_ (0),
  option_length_specified_ (false),
  ansi_color_ (),
  exclude_base_ (),
  include_base_last_ (),
  class_doc_ (),
  class_doc_specified_ (false),
  class__ (),
  class__specified_ (false),
  docvar_ (),
  docvar_specified_ (false),
  link_regex_ (),
  link_regex_specified_ (false),
  link_regex_trace_ (),
  html_heading_map_ (),
  html_heading_map_specified_ (false),
  omit_link_check_ (),
  hxx_prologue_ (),
  hxx_prologue_specified_ (false),
  ixx_prologue_ (),
  ixx_prologue_specified_ (false),
  cxx_prologue_ (),
  cxx_prologue_specified_ (false),
  man_prologue_ (),
  man_prologue_specified_ (false),
  html_prologue_ (),
  html_prologue_specified_ (false),
  txt_prologue_ (),
  txt_prologue_specified_ (false),
  hxx_epilogue_ (),
  hxx_epilogue_specified_ (false),
  ixx_epilogue_ (),
  ixx_epilogue_specified_ (false),
  cxx_epilogue_ (),
  cxx_epilogue_specified_ (false),
  man_epilogue_ (),
  man_epilogue_specified_ (false),
  html_epilogue_ (),
  html_epilogue_specified_ (false),
  txt_epilogue_ (),
  txt_epilogue_specified_ (false),
  hxx_prologue_file_ (),
  hxx_prologue_file_specified_ (false),
  ixx_prologue_file_ (),
  ixx_prologue_file_specified_ (false),
  cxx_prologue_file_ (),
  cxx_prologue_file_specified_ (false),
  man_prologue_file_ (),
  man_prologue_file_specified_ (false),
  html_prologue_file_ (),
  html_prologue_file_specified_ (false),
  txt_prologue_file_ (),
  txt_prologue_file_specified_ (false),
  hxx_epilogue_file_ (),
  hxx_epilogue_file_specified_ (false),
  ixx_epilogue_file_ (),
  ixx_epilogue_file_specified_ (false),
  cxx_epilogue_file_ (),
  cxx_epilogue_file_specified_ (false),
  man_epilogue_file_ (),
  man_epilogue_file_specified_ (false),
  html_epilogue_file_ (),
  html_epilogue_file_specified_ (false),
  txt_epilogue_file_ (),
  txt_epilogue_file_specified_ (false),
  output_prefix_ (),
  output_prefix_specified_ (false),
  output_suffix_ (),
  output_suffix_specified_ (false),
  hxx_suffix_ (".hxx"),
  hxx_suffix_specified_ (false),
  ixx_suffix_ (".ixx"),
  ixx_suffix_specified_ (false),
  cxx_suffix_ (".cxx"),
  cxx_suffix_specified_ (false),
  man_suffix_ (".1"),
  man_suffix_specified_ (false),
  html_suffix_ (".html"),
  html_suffix_specified_ (false),
  txt_suffix_ (".txt"),
  txt_suffix_specified_ (false),
  option_prefix_ ("-"),
  option_prefix_specified_ (false),
  option_separator_ ("--"),
  option_separator_specified_ (false),
  keep_separator_ (),
  no_combined_flags_ (),
  no_combined_values_ (),
  include_with_brackets_ (),
  include_prefix_ (),
  include_prefix_specified_ (false),
  guard_prefix_ (),
  guard_prefix_specified_ (false),
  reserved_name_ (),
  reserved_name_specified_ (false),
  options_file_ (),
  options_file_specified_ (false)
{
  ::cli::argv_scanner s (start, argc, argv, erase);
  _parse (s, opt, arg);
  end = s.end ();
}

options::
options (::cli::scanner& s,
         ::cli::unknown_mode opt,
         ::cli::unknown_mode arg)
: help_ (),
  version_ (),
  include_path_ (),
  include_path_specified_ (false),
  output_dir_ (),
  output_dir_specified_ (false),
  std_ (cxx_version::cxx98),
  std_specified_ (false),
  generate_modifier_ (),
  generate_specifier_ (),
  generate_parse_ (),
  generate_description_ (),
  generate_file_scanner_ (),
  generate_vector_scanner_ (),
  generate_group_scanner_ (),
  suppress_inline_ (),
  suppress_cli_ (),
  cli_namespace_ ("::cli"),
  cli_namespace_specified_ (false),
  ostream_type_ ("::std::ostream"),
  ostream_type_specified_ (false),
  generate_cxx_ (),
  generate_man_ (),
  generate_html_ (),
  generate_txt_ (),
  stdout__ (),
  suppress_undocumented_ (),
  suppress_usage_ (),
  long_usage_ (),
  short_usage_ (),
  page_usage_ (),
  page_usage_specified_ (false),
  option_length_ (0),
  option_length_specified_ (false),
  ansi_color_ (),
  exclude_base_ (),
  include_base_last_ (),
  class_doc_ (),
  class_doc_specified_ (false),
  class__ (),
  class__specified_ (false),
  docvar_ (),
  docvar_specified_ (false),
  link_regex_ (),
  link_regex_specified_ (false),
  link_regex_trace_ (),
  html_heading_map_ (),
  html_heading_map_specified_ (false),
  omit_link_check_ (),
  hxx_prologue_ (),
  hxx_prologue_specified_ (false),
  ixx_prologue_ (),
  ixx_prologue_specified_ (false),
  cxx_prologue_ (),
  cxx_prologue_specified_ (false),
  man_prologue_ (),
  man_prologue_specified_ (false),
  html_prologue_ (),
  html_prologue_specified_ (false),
  txt_prologue_ (),
  txt_prologue_specified_ (false),
  hxx_epilogue_ (),
  hxx_epilogue_specified_ (false),
  ixx_epilogue_ (),
  ixx_epilogue_specified_ (false),
  cxx_epilogue_ (),
  cxx_epilogue_specified_ (false),
  man_epilogue_ (),
  man_epilogue_specified_ (false),
  html_epilogue_ (),
  html_epilogue_specified_ (false),
  txt_epilogue_ (),
  txt_epilogue_specified_ (false),
  hxx_prologue_file_ (),
  hxx_prologue_file_specified_ (false),
  ixx_prologue_file_ (),
  ixx_prologue_file_specified_ (false),
  cxx_prologue_file_ (),
  cxx_prologue_file_specified_ (false),
  man_prologue_file_ (),
  man_prologue_file_specified_ (false),
  html_prologue_file_ (),
  html_prologue_file_specified_ (false),
  txt_prologue_file_ (),
  txt_prologue_file_specified_ (false),
  hxx_epilogue_file_ (),
  hxx_epilogue_file_specified_ (false),
  ixx_epilogue_file_ (),
  ixx_epilogue_file_specified_ (false),
  cxx_epilogue_file_ (),
  cxx_epilogue_file_specified_ (false),
  man_epilogue_file_ (),
  man_epilogue_file_specified_ (false),
  html_epilogue_file_ (),
  html_epilogue_file_specified_ (false),
  txt_epilogue_file_ (),
  txt_epilogue_file_specified_ (false),
  output_prefix_ (),
  output_prefix_specified_ (false),
  output_suffix_ (),
  output_suffix_specified_ (false),
  hxx_suffix_ (".hxx"),
  hxx_suffix_specified_ (false),
  ixx_suffix_ (".ixx"),
  ixx_suffix_specified_ (false),
  cxx_suffix_ (".cxx"),
  cxx_suffix_specified_ (false),
  man_suffix_ (".1"),
  man_suffix_specified_ (false),
  html_suffix_ (".html"),
  html_suffix_specified_ (false),
  txt_suffix_ (".txt"),
  txt_suffix_specified_ (false),
  option_prefix_ ("-"),
  option_prefix_specified_ (false),
  option_separator_ ("--"),
  option_separator_specified_ (false),
  keep_separator_ (),
  no_combined_flags_ (),
  no_combined_values_ (),
  include_with_brackets_ (),
  include_prefix_ (),
  include_prefix_specified_ (false),
  guard_prefix_ (),
  guard_prefix_specified_ (false),
  reserved_name_ (),
  reserved_name_specified_ (false),
  options_file_ (),
  options_file_specified_ (false)
{
  _parse (s, opt, arg);
}

::cli::usage_para options::
print_usage (::std::ostream& os, ::cli::usage_para p)
{
  CLI_POTENTIALLY_UNUSED (os);

  if (p == ::cli::usage_para::text)
    os << ::std::endl;

  os << "--help                       Print usage information and exit." << ::std::endl;

  os << "--version                    Print version and exit." << ::std::endl;

  os << "--include-path|-I <dir>      Search <dir> for bracket-included (<>) options" << ::std::endl
     << "                             files." << ::std::endl;

  os << "--output-dir|-o <dir>        Write the generated files to <dir> instead of the" << ::std::endl
     << "                             current directory." << ::std::endl;

  os << "--std <version>              Specify the C++ standard that should be used" << ::std::endl
     << "                             during compilation." << ::std::endl;

  os << "--generate-modifier          Generate option value modifiers in addition to" << ::std::endl
     << "                             accessors." << ::std::endl;

  os << "--generate-specifier         Generate functions for determining whether the" << ::std::endl
     << "                             option was specified on the command line." << ::std::endl;

  os << "--generate-parse             Generate parse() functions instead of parsing" << ::std::endl
     << "                             constructors." << ::std::endl;

  os << "--generate-description       Generate the option description list that can be" << ::std::endl
     << "                             examined at runtime." << ::std::endl;

  os << "--generate-file-scanner      Generate the argv_file_scanner implementation." << ::std::endl;

  os << "--generate-vector-scanner    Generate the vector_scanner implementation." << ::std::endl;

  os << "--generate-group-scanner     Generate the group_scanner implementation." << ::std::endl;

  os << "--suppress-inline            Generate all functions non-inline." << ::std::endl;

  os << "--suppress-cli               Do not generate the CLI support types (scanners," << ::std::endl
     << "                             parser, etc)." << ::std::endl;

  os << "--cli-namespace <ns>         Generate the CLI support types in the <ns>" << ::std::endl
     << "                             namespace (cli by default)." << ::std::endl;

  os << "--ostream-type <type>        Output stream type instead of the default" << ::std::endl
     << "                             std::ostream that should be used to print usage" << ::std::endl
     << "                             and exception information." << ::std::endl;

  os << "--generate-cxx               Generate C++ code." << ::std::endl;

  os << "--generate-man               Generate documentation in the man page format." << ::std::endl;

  os << "--generate-html              Generate documentation in the HTML format." << ::std::endl;

  os << "--generate-txt               Generate documentation in the plain text format," << ::std::endl
     << "                             similar to usage." << ::std::endl;

  os << "--stdout                     Write output to STDOUT instead of a file." << ::std::endl;

  os << "--suppress-undocumented      Suppress the generation of documentation entries" << ::std::endl
     << "                             for undocumented options." << ::std::endl;

  os << "--suppress-usage             Suppress the generation of the usage printing" << ::std::endl
     << "                             code." << ::std::endl;

  os << "--long-usage                 If no short documentation string is provided, use" << ::std::endl
     << "                             the complete long documentation string in usage." << ::std::endl;

  os << "--short-usage                If specified together with --long-usage, generate" << ::std::endl
     << "                             both short and long usage versions." << ::std::endl;

  os << "--page-usage <name>          Generate the combined usage printing code for the" << ::std::endl
     << "                             entire page." << ::std::endl;

  os << "--option-length <len>        Indent option descriptions <len> characters when" << ::std::endl
     << "                             printing usage." << ::std::endl;

  os << "--ansi-color                 Use ANSI color escape sequences when printing" << ::std::endl
     << "                             usage." << ::std::endl;

  os << "--exclude-base               Exclude base class information from usage and" << ::std::endl
     << "                             documentation." << ::std::endl;

  os << "--include-base-last          Include base class information after derived for" << ::std::endl
     << "                             usage and documentation." << ::std::endl;

  os << "--class-doc <name>=<kind>    Specify the documentation <kind> that should be" << ::std::endl
     << "                             used for the options class <name>." << ::std::endl;

  os << "--class <name>               Generate the man page, HTML, or text documentation" << ::std::endl
     << "                             only for the options class <name>." << ::std::endl;

  os << "--docvar|-v <name>=<val>     Set documentation variable <name> to the value" << ::std::endl
     << "                             <val>." << ::std::endl;

  os << "--link-regex <regex>         Add <regex> to the list of regular expressions" << ::std::endl
     << "                             used to transform link targets in the generated" << ::std::endl
     << "                             documentation." << ::std::endl;

  os << "--link-regex-trace           Trace the process of applying regular expressions" << ::std::endl
     << "                             specified with the --link-regex option." << ::std::endl;

  os << "--html-heading-map <c>=<h>   Map CLI heading <c> (valid values: 'H', '0', '1'," << ::std::endl
     << "                             'h', and '2') to HTML heading <h> (for example," << ::std::endl
     << "                             'h1', 'h2', etc)." << ::std::endl;

  os << "--omit-link-check            Don't check that local fragment link references" << ::std::endl
     << "                             (\\l{#ref ...}) resolve to ids." << ::std::endl;

  os << "--hxx-prologue <text>        Insert <text> at the beginning of the generated" << ::std::endl
     << "                             C++ header file." << ::std::endl;

  os << "--ixx-prologue <text>        Insert <text> at the beginning of the generated" << ::std::endl
     << "                             C++ inline file." << ::std::endl;

  os << "--cxx-prologue <text>        Insert <text> at the beginning of the generated" << ::std::endl
     << "                             C++ source file." << ::std::endl;

  os << "--man-prologue <text>        Insert <text> at the beginning of the generated" << ::std::endl
     << "                             man page file." << ::std::endl;

  os << "--html-prologue <text>       Insert <text> at the beginning of the generated" << ::std::endl
     << "                             HTML file." << ::std::endl;

  os << "--txt-prologue <text>        Insert <text> at the beginning of the generated" << ::std::endl
     << "                             text file." << ::std::endl;

  os << "--hxx-epilogue <text>        Insert <text> at the end of the generated C++" << ::std::endl
     << "                             header file." << ::std::endl;

  os << "--ixx-epilogue <text>        Insert <text> at the end of the generated C++" << ::std::endl
     << "                             inline file." << ::std::endl;

  os << "--cxx-epilogue <text>        Insert <text> at the end of the generated C++" << ::std::endl
     << "                             source file." << ::std::endl;

  os << "--man-epilogue <text>        Insert <text> at the end of the generated man page" << ::std::endl
     << "                             file." << ::std::endl;

  os << "--html-epilogue <text>       Insert <text> at the end of the generated HTML" << ::std::endl
     << "                             file." << ::std::endl;

  os << "--txt-epilogue <text>        Insert <text> at the end of the generated text" << ::std::endl
     << "                             file." << ::std::endl;

  os << "--hxx-prologue-file <file>   Insert the content of <file> at the beginning of" << ::std::endl
     << "                             the generated C++ header file." << ::std::endl;

  os << "--ixx-prologue-file <file>   Insert the content of <file> at the beginning of" << ::std::endl
     << "                             the generated C++ inline file." << ::std::endl;

  os << "--cxx-prologue-file <file>   Insert the content of <file> at the beginning of" << ::std::endl
     << "                             the generated C++ source file." << ::std::endl;

  os << "--man-prologue-file <file>   Insert the content of <file> at the beginning of" << ::std::endl
     << "                             the generated man page file." << ::std::endl;

  os << "--html-prologue-file <file>  Insert the content of <file> at the beginning of" << ::std::endl
     << "                             the generated HTML file." << ::std::endl;

  os << "--txt-prologue-file <file>   Insert the content of <file> at the beginning of" << ::std::endl
     << "                             the generated text file." << ::std::endl;

  os << "--hxx-epilogue-file <file>   Insert the content of <file> at the end of the" << ::std::endl
     << "                             generated C++ header file." << ::std::endl;

  os << "--ixx-epilogue-file <file>   Insert the content of <file> at the end of the" << ::std::endl
     << "                             generated C++ inline file." << ::std::endl;

  os << "--cxx-epilogue-file <file>   Insert the content of <file> at the end of the" << ::std::endl
     << "                             generated C++ source file." << ::std::endl;

  os << "--man-epilogue-file <file>   Insert the content of <file> at the end of the" << ::std::endl
     << "                             generated man page file." << ::std::endl;

  os << "--html-epilogue-file <file>  Insert the content of <file> at the end of the" << ::std::endl
     << "                             generated HTML file." << ::std::endl;

  os << "--txt-epilogue-file <file>   Insert the content of <file> at the end of the" << ::std::endl
     << "                             generated text file." << ::std::endl;

  os << "--output-prefix <prefix>     Add <prefix> at the beginning of the generated" << ::std::endl
     << "                             output file name(s)." << ::std::endl;

  os << "--output-suffix <suffix>     Add <suffix> at the end of the generated output" << ::std::endl
     << "                             file name(s)." << ::std::endl;

  os << "--hxx-suffix <suffix>        Use <suffix> instead of the default .hxx to" << ::std::endl
     << "                             construct the name of the generated header file." << ::std::endl;

  os << "--ixx-suffix <suffix>        Use <suffix> instead of the default .ixx to" << ::std::endl
     << "                             construct the name of the generated inline file." << ::std::endl;

  os << "--cxx-suffix <suffix>        Use <suffix> instead of the default .cxx to" << ::std::endl
     << "                             construct the name of the generated source file." << ::std::endl;

  os << "--man-suffix <suffix>        Use <suffix> instead of the default .1 to" << ::std::endl
     << "                             construct the name of the generated man page file." << ::std::endl;

  os << "--html-suffix <suffix>       Use <suffix> instead of the default .html to" << ::std::endl
     << "                             construct the name of the generated HTML file." << ::std::endl;

  os << "--txt-suffix <suffix>        Use <suffix> instead of the default .txt to" << ::std::endl
     << "                             construct the name of the generated text file." << ::std::endl;

  os << "--option-prefix <prefix>     Use <prefix> instead of the default '-' as an" << ::std::endl
     << "                             option prefix." << ::std::endl;

  os << "--option-separator <sep>     Use <sep> instead of the default '--' as an" << ::std::endl
     << "                             optional separator between options and arguments." << ::std::endl;

  os << "--keep-separator             Leave the option separator in the scanner." << ::std::endl;

  os << "--no-combined-flags          Disable support for combining multiple" << ::std::endl
     << "                             single-character flags into a single argument (the" << ::std::endl
     << "                             -xyz form that is equivalent to -x -y -z)." << ::std::endl;

  os << "--no-combined-values         Disable support for combining an option and its" << ::std::endl
     << "                             value into a single argument with the assignment" << ::std::endl
     << "                             sign (the option=value form)." << ::std::endl;

  os << "--include-with-brackets      Use angle brackets (<>) instead of quotes (\"\") in" << ::std::endl
     << "                             the generated #include directives." << ::std::endl;

  os << "--include-prefix <prefix>    Add <prefix> to the generated #include directive" << ::std::endl
     << "                             paths." << ::std::endl;

  os << "--guard-prefix <prefix>      Add <prefix> to the generated header inclusion" << ::std::endl
     << "                             guards." << ::std::endl;

  os << "--reserved-name <name>=<rep> Add <name> with an optional <rep> replacement to" << ::std::endl
     << "                             the list of names that should not be used as" << ::std::endl
     << "                             identifiers." << ::std::endl;

  os << "--options-file <file>        Read additional options from <file>." << ::std::endl;

  p = ::cli::usage_para::option;

  return p;
}

typedef
std::map<std::string, void (*) (options&, ::cli::scanner&)>
_cli_options_map;

static _cli_options_map _cli_options_map_;

struct _cli_options_map_init
{
  _cli_options_map_init ()
  {
    _cli_options_map_["--help"] = 
    &::cli::thunk< options, bool, &options::help_ >;
    _cli_options_map_["--version"] = 
    &::cli::thunk< options, bool, &options::version_ >;
    _cli_options_map_["--include-path"] = 
    &::cli::thunk< options, std::vector<std::string>, &options::include_path_,
      &options::include_path_specified_ >;
    _cli_options_map_["-I"] = 
    &::cli::thunk< options, std::vector<std::string>, &options::include_path_,
      &options::include_path_specified_ >;
    _cli_options_map_["--output-dir"] = 
    &::cli::thunk< options, std::string, &options::output_dir_,
      &options::output_dir_specified_ >;
    _cli_options_map_["-o"] = 
    &::cli::thunk< options, std::string, &options::output_dir_,
      &options::output_dir_specified_ >;
    _cli_options_map_["--std"] = 
    &::cli::thunk< options, cxx_version, &options::std_,
      &options::std_specified_ >;
    _cli_options_map_["--generate-modifier"] = 
    &::cli::thunk< options, bool, &options::generate_modifier_ >;
    _cli_options_map_["--generate-specifier"] = 
    &::cli::thunk< options, bool, &options::generate_specifier_ >;
    _cli_options_map_["--generate-parse"] = 
    &::cli::thunk< options, bool, &options::generate_parse_ >;
    _cli_options_map_["--generate-description"] = 
    &::cli::thunk< options, bool, &options::generate_description_ >;
    _cli_options_map_["--generate-file-scanner"] = 
    &::cli::thunk< options, bool, &options::generate_file_scanner_ >;
    _cli_options_map_["--generate-vector-scanner"] = 
    &::cli::thunk< options, bool, &options::generate_vector_scanner_ >;
    _cli_options_map_["--generate-group-scanner"] = 
    &::cli::thunk< options, bool, &options::generate_group_scanner_ >;
    _cli_options_map_["--suppress-inline"] = 
    &::cli::thunk< options, bool, &options::suppress_inline_ >;
    _cli_options_map_["--suppress-cli"] = 
    &::cli::thunk< options, bool, &options::suppress_cli_ >;
    _cli_options_map_["--cli-namespace"] = 
    &::cli::thunk< options, std::string, &options::cli_namespace_,
      &options::cli_namespace_specified_ >;
    _cli_options_map_["--ostream-type"] = 
    &::cli::thunk< options, std::string, &options::ostream_type_,
      &options::ostream_type_specified_ >;
    _cli_options_map_["--generate-cxx"] = 
    &::cli::thunk< options, bool, &options::generate_cxx_ >;
    _cli_options_map_["--generate-man"] = 
    &::cli::thunk< options, bool, &options::generate_man_ >;
    _cli_options_map_["--generate-html"] = 
    &::cli::thunk< options, bool, &options::generate_html_ >;
    _cli_options_map_["--generate-txt"] = 
    &::cli::thunk< options, bool, &options::generate_txt_ >;
    _cli_options_map_["--stdout"] = 
    &::cli::thunk< options, bool, &options::stdout__ >;
    _cli_options_map_["--suppress-undocumented"] = 
    &::cli::thunk< options, bool, &options::suppress_undocumented_ >;
    _cli_options_map_["--suppress-usage"] = 
    &::cli::thunk< options, bool, &options::suppress_usage_ >;
    _cli_options_map_["--long-usage"] = 
    &::cli::thunk< options, bool, &options::long_usage_ >;
    _cli_options_map_["--short-usage"] = 
    &::cli::thunk< options, bool, &options::short_usage_ >;
    _cli_options_map_["--page-usage"] = 
    &::cli::thunk< options, std::string, &options::page_usage_,
      &options::page_usage_specified_ >;
    _cli_options_map_["--option-length"] = 
    &::cli::thunk< options, std::size_t, &options::option_length_,
      &options::option_length_specified_ >;
    _cli_options_map_["--ansi-color"] = 
    &::cli::thunk< options, bool, &options::ansi_color_ >;
    _cli_options_map_["--exclude-base"] = 
    &::cli::thunk< options, bool, &options::exclude_base_ >;
    _cli_options_map_["--include-base-last"] = 
    &::cli::thunk< options, bool, &options::include_base_last_ >;
    _cli_options_map_["--class-doc"] = 
    &::cli::thunk< options, std::map<std::string, std::string>, &options::class_doc_,
      &options::class_doc_specified_ >;
    _cli_options_map_["--class"] = 
    &::cli::thunk< options, std::vector<std::string>, &options::class__,
      &options::class__specified_ >;
    _cli_options_map_["--docvar"] = 
    &::cli::thunk< options, std::map<std::string, std::string>, &options::docvar_,
      &options::docvar_specified_ >;
    _cli_options_map_["-v"] = 
    &::cli::thunk< options, std::map<std::string, std::string>, &options::docvar_,
      &options::docvar_specified_ >;
    _cli_options_map_["--link-regex"] = 
    &::cli::thunk< options, std::vector<std::string>, &options::link_regex_,
      &options::link_regex_specified_ >;
    _cli_options_map_["--link-regex-trace"] = 
    &::cli::thunk< options, bool, &options::link_regex_trace_ >;
    _cli_options_map_["--html-heading-map"] = 
    &::cli::thunk< options, std::map<char, std::string>, &options::html_heading_map_,
      &options::html_heading_map_specified_ >;
    _cli_options_map_["--omit-link-check"] = 
    &::cli::thunk< options, bool, &options::omit_link_check_ >;
    _cli_options_map_["--hxx-prologue"] = 
    &::cli::thunk< options, std::vector<std::string>, &options::hxx_prologue_,
      &options::hxx_prologue_specified_ >;
    _cli_options_map_["--ixx-prologue"] = 
    &::cli::thunk< options, std::vector<std::string>, &options::ixx_prologue_,
      &options::ixx_prologue_specified_ >;
    _cli_options_map_["--cxx-prologue"] = 
    &::cli::thunk< options, std::vector<std::string>, &options::cxx_prologue_,
      &options::cxx_prologue_specified_ >;
    _cli_options_map_["--man-prologue"] = 
    &::cli::thunk< options, std::vector<std::string>, &options::man_prologue_,
      &options::man_prologue_specified_ >;
    _cli_options_map_["--html-prologue"] = 
    &::cli::thunk< options, std::vector<std::string>, &options::html_prologue_,
      &options::html_prologue_specified_ >;
    _cli_options_map_["--txt-prologue"] = 
    &::cli::thunk< options, std::vector<std::string>, &options::txt_prologue_,
      &options::txt_prologue_specified_ >;
    _cli_options_map_["--hxx-epilogue"] = 
    &::cli::thunk< options, std::vector<std::string>, &options::hxx_epilogue_,
      &options::hxx_epilogue_specified_ >;
    _cli_options_map_["--ixx-epilogue"] = 
    &::cli::thunk< options, std::vector<std::string>, &options::ixx_epilogue_,
      &options::ixx_epilogue_specified_ >;
    _cli_options_map_["--cxx-epilogue"] = 
    &::cli::thunk< options, std::vector<std::string>, &options::cxx_epilogue_,
      &options::cxx_epilogue_specified_ >;
    _cli_options_map_["--man-epilogue"] = 
    &::cli::thunk< options, std::vector<std::string>, &options::man_epilogue_,
      &options::man_epilogue_specified_ >;
    _cli_options_map_["--html-epilogue"] = 
    &::cli::thunk< options, std::vector<std::string>, &options::html_epilogue_,
      &options::html_epilogue_specified_ >;
    _cli_options_map_["--txt-epilogue"] = 
    &::cli::thunk< options, std::vector<std::string>, &options::txt_epilogue_,
      &options::txt_epilogue_specified_ >;
    _cli_options_map_["--hxx-prologue-file"] = 
    &::cli::thunk< options, std::string, &options::hxx_prologue_file_,
      &options::hxx_prologue_file_specified_ >;
    _cli_options_map_["--ixx-prologue-file"] = 
    &::cli::thunk< options, std::string, &options::ixx_prologue_file_,
      &options::ixx_prologue_file_specified_ >;
    _cli_options_map_["--cxx-prologue-file"] = 
    &::cli::thunk< options, std::string, &options::cxx_prologue_file_,
      &options::cxx_prologue_file_specified_ >;
    _cli_options_map_["--man-prologue-file"] = 
    &::cli::thunk< options, std::string, &options::man_prologue_file_,
      &options::man_prologue_file_specified_ >;
    _cli_options_map_["--html-prologue-file"] = 
    &::cli::thunk< options, std::string, &options::html_prologue_file_,
      &options::html_prologue_file_specified_ >;
    _cli_options_map_["--txt-prologue-file"] = 
    &::cli::thunk< options, std::string, &options::txt_prologue_file_,
      &options::txt_prologue_file_specified_ >;
    _cli_options_map_["--hxx-epilogue-file"] = 
    &::cli::thunk< options, std::string, &options::hxx_epilogue_file_,
      &options::hxx_epilogue_file_specified_ >;
    _cli_options_map_["--ixx-epilogue-file"] = 
    &::cli::thunk< options, std::string, &options::ixx_epilogue_file_,
      &options::ixx_epilogue_file_specified_ >;
    _cli_options_map_["--cxx-epilogue-file"] = 
    &::cli::thunk< options, std::string, &options::cxx_epilogue_file_,
      &options::cxx_epilogue_file_specified_ >;
    _cli_options_map_["--man-epilogue-file"] = 
    &::cli::thunk< options, std::string, &options::man_epilogue_file_,
      &options::man_epilogue_file_specified_ >;
    _cli_options_map_["--html-epilogue-file"] = 
    &::cli::thunk< options, std::string, &options::html_epilogue_file_,
      &options::html_epilogue_file_specified_ >;
    _cli_options_map_["--txt-epilogue-file"] = 
    &::cli::thunk< options, std::string, &options::txt_epilogue_file_,
      &options::txt_epilogue_file_specified_ >;
    _cli_options_map_["--output-prefix"] = 
    &::cli::thunk< options, std::string, &options::output_prefix_,
      &options::output_prefix_specified_ >;
    _cli_options_map_["--output-suffix"] = 
    &::cli::thunk< options, std::string, &options::output_suffix_,
      &options::output_suffix_specified_ >;
    _cli_options_map_["--hxx-suffix"] = 
    &::cli::thunk< options, std::string, &options::hxx_suffix_,
      &options::hxx_suffix_specified_ >;
    _cli_options_map_["--ixx-suffix"] = 
    &::cli::thunk< options, std::string, &options::ixx_suffix_,
      &options::ixx_suffix_specified_ >;
    _cli_options_map_["--cxx-suffix"] = 
    &::cli::thunk< options, std::string, &options::cxx_suffix_,
      &options::cxx_suffix_specified_ >;
    _cli_options_map_["--man-suffix"] = 
    &::cli::thunk< options, std::string, &options::man_suffix_,
      &options::man_suffix_specified_ >;
    _cli_options_map_["--html-suffix"] = 
    &::cli::thunk< options, std::string, &options::html_suffix_,
      &options::html_suffix_specified_ >;
    _cli_options_map_["--txt-suffix"] = 
    &::cli::thunk< options, std::string, &options::txt_suffix_,
      &options::txt_suffix_specified_ >;
    _cli_options_map_["--option-prefix"] = 
    &::cli::thunk< options, std::string, &options::option_prefix_,
      &options::option_prefix_specified_ >;
    _cli_options_map_["--option-separator"] = 
    &::cli::thunk< options, std::string, &options::option_separator_,
      &options::option_separator_specified_ >;
    _cli_options_map_["--keep-separator"] = 
    &::cli::thunk< options, bool, &options::keep_separator_ >;
    _cli_options_map_["--no-combined-flags"] = 
    &::cli::thunk< options, bool, &options::no_combined_flags_ >;
    _cli_options_map_["--no-combined-values"] = 
    &::cli::thunk< options, bool, &options::no_combined_values_ >;
    _cli_options_map_["--include-with-brackets"] = 
    &::cli::thunk< options, bool, &options::include_with_brackets_ >;
    _cli_options_map_["--include-prefix"] = 
    &::cli::thunk< options, std::string, &options::include_prefix_,
      &options::include_prefix_specified_ >;
    _cli_options_map_["--guard-prefix"] = 
    &::cli::thunk< options, std::string, &options::guard_prefix_,
      &options::guard_prefix_specified_ >;
    _cli_options_map_["--reserved-name"] = 
    &::cli::thunk< options, std::map<std::string, std::string>, &options::reserved_name_,
      &options::reserved_name_specified_ >;
    _cli_options_map_["--options-file"] = 
    &::cli::thunk< options, std::string, &options::options_file_,
      &options::options_file_specified_ >;
  }
};

static _cli_options_map_init _cli_options_map_init_;

bool options::
_parse (const char* o, ::cli::scanner& s)
{
  _cli_options_map::const_iterator i (_cli_options_map_.find (o));

  if (i != _cli_options_map_.end ())
  {
    (*(i->second)) (*this, s);
    return true;
  }

  return false;
}

bool options::
_parse (::cli::scanner& s,
        ::cli::unknown_mode opt_mode,
        ::cli::unknown_mode arg_mode)
{
  // Can't skip combined flags (--no-combined-flags).
  //
  assert (opt_mode != ::cli::unknown_mode::skip);

  bool r = false;
  bool opt = true;

  while (s.more ())
  {
    const char* o = s.peek ();

    if (std::strcmp (o, "--") == 0)
    {
      opt = false;
      s.skip ();
      r = true;
      continue;
    }

    if (opt)
    {
      if (_parse (o, s))
      {
        r = true;
        continue;
      }

      if (std::strncmp (o, "-", 1) == 0 && o[1] != '\0')
      {
        // Handle combined option values.
        //
        std::string co;
        if (const char* v = std::strchr (o, '='))
        {
          co.assign (o, 0, v - o);
          ++v;

          int ac (2);
          char* av[] =
          {
            const_cast<char*> (co.c_str ()),
            const_cast<char*> (v)
          };

          ::cli::argv_scanner ns (0, ac, av);

          if (_parse (co.c_str (), ns))
          {
            // Parsed the option but not its value?
            //
            if (ns.end () != 2)
              throw ::cli::invalid_value (co, v);

            s.next ();
            r = true;
            continue;
          }
          else
          {
            // Set the unknown option and fall through.
            //
            o = co.c_str ();
          }
        }

        // Handle combined flags.
        //
        char cf[3];
        {
          const char* p = o + 1;
          for (; *p != '\0'; ++p)
          {
            if (!((*p >= 'a' && *p <= 'z') ||
                  (*p >= 'A' && *p <= 'Z') ||
                  (*p >= '0' && *p <= '9')))
              break;
          }

          if (*p == '\0')
          {
            for (p = o + 1; *p != '\0'; ++p)
            {
              std::strcpy (cf, "-");
              cf[1] = *p;
              cf[2] = '\0';

              int ac (1);
              char* av[] = 
              {
                cf
              };

              ::cli::argv_scanner ns (0, ac, av);

              if (!_parse (cf, ns))
                break;
            }

            if (*p == '\0')
            {
              // All handled.
              //
              s.next ();
              r = true;
              continue;
            }
            else
            {
              // Set the unknown option and fall through.
              //
              o = cf;
            }
          }
        }

        switch (opt_mode)
        {
          case ::cli::unknown_mode::skip:
          {
            s.skip ();
            r = true;
            continue;
          }
          case ::cli::unknown_mode::stop:
          {
            break;
          }
          case ::cli::unknown_mode::fail:
          {
            throw ::cli::unknown_option (o);
          }
        }

        break;
      }
    }

    switch (arg_mode)
    {
      case ::cli::unknown_mode::skip:
      {
        s.skip ();
        r = true;
        continue;
      }
      case ::cli::unknown_mode::stop:
      {
        break;
      }
      case ::cli::unknown_mode::fail:
      {
        throw ::cli::unknown_argument (o);
      }
    }

    break;
  }

  return r;
}

// Begin epilogue.
//
//
// End epilogue.