void SetupConfiguration	(	Configuration &	conf,
		int &	opt
	)

Main Doxygen/Autotools integration example program.

Parameters

conf	Number of command line options.
opt	The command line options.

Returns

The exit status.

Examples:

argv.cc.

Definition at line 15 of file argv.cc.

References Configuration::AddEnv(), Configuration::AddOptionsCommandline(), Configuration::AddOptionsConfigfile(), Configuration::AddOptionsDatabase(), Configuration::AddOptionsEnvironment(), po_switch(), and Configuration::SetArgumentPositions().

Referenced by main().

{
    /*
     // Default in case the option was not specified
     typed_value* default_value(const T& v)
     typed_value* default_value(const T& v, const std::string& textual)

     // Default value in case the option was given
     //    forces -o    to become -o5
     //    forces --opt to become --opt=3
     typed_value* implicit_value(const T &v)
     typed_value* implicit_value(const T &v, const std::string& textual)

     // notifier function when the final value is determined
     typed_value* notifier(function1<void, const T&> f)

     typed_value* composing()

     // Specifies that the value can span multiple tokens.
     typed_value* multitoken()
     typed_value* zero_tokens()

     // Specifies that the value must occur.
     typed_value* required()
     */

    // To merge the options from several parsers (e.g. comand_line and
    // config file) use po_strings()->composing()
    /*
    po::options_description generic("Generic options");
    generic.add_options()
        ("help-config",   "Print available configuration file options.")
        ("help-env",      "Print available environment variables.")
        ("help",          "Print available commandline options.")
        ("print-unknown", "Print unrecognized options.")
        ("config", po_string("config.txt"), "Set configuration file name.")
        ;


    // Declare the supported options.
    po::options_description generic("Generaic options");
    generic.add_options()
//        ("testreq",     po_int()->required(),         "set compression level (madatory)")
        ("default",     po_string("my_default"),      "set compression level")
        ("unknown",     po_int(1),                    "set compression level")
        ("U",           po_int(2)->implicit_value(1), "set compression level")
        ;
      */
    // Declare a group of options that will be
    // allowed both on command line and in
    // config file
    po::options_description config("Configuration");
    config.add_options()
        ("compression",    var<int>(),                      "set compression level")
        ("optimization",   var<int>(10, &opt),              "optimization level")
        ("test-def",       var<int>(42),                    "optimization level")
        ("include-path,I", vars<string>()/*->composing()*/, "include path")
        ("test,T",         vars<string>()/*->composing()*/, "include path")
        ("file1",          vars<string>(),                   "include path")
        ("int1",           var<int>(),                      "include path")
        ("Int2",           var<int>(),                      "include path")
        ("Int1",           var<int>(),                      "include path")
        ("test-db",        var<string>("database"),                      "include path")
        ("float1",         var<double>(),                   "include path")
//        (",A",          po_float(),                    "include path")
        ("radec",         po::value<vector<double>>(),                    "include path")
        ("switch",        po_switch(),                    "include path")
        ("bool",          var<bool>()->implicit_value(true),                    "include path")
        ;

    // !!! Option which are "shorted" must be placed last.
    //     Can this be switched off?

    po::options_description sections("Sections");
    config.add_options()
        ("unregistered",            var<string>(),                    "include path")
        ("Section1.unregistered",   var<string>(),                    "include path")
//        ("Section2*",               po_string(),                    "include path")
        // The latter accepts all options starting with Section2.
        ;

    // Hidden options, will be allowed both on command line and
    // in config file, but will not be shown to the user.
    po::options_description hidden("Hidden options");
    hidden.add_options()
        ("input-file",  vars<string>(), "input file")
        ("output-file", vars<string>(), "output file")
        ("test-file",   vars<string>(), "test file")
        ;

    po::options_description env("Environment options");
    env.add_options()
        ("linux", var<string>(), "LINUX env")
        ("path",  var<string>(), "PATH env")
        ("dns",   var<string>(), "DIM_DNS_SERVER env")
        ;

    conf.AddEnv("linux", "LINUX");
    conf.AddEnv("path",  "PATH");
    conf.AddEnv("dns",   "DIM_DNS_SERVER");

    // define translation from position to name
    po::positional_options_description p;
    p.add("output-file", 2); // The first 2 positional options is output-file
    p.add("test-file",   3); // The next three positional options is output-file
    p.add("input-file", -1); // All others go to...

    conf.AddOptionsCommandline(config);
    conf.AddOptionsCommandline(sections);
    conf.AddOptionsCommandline(hidden, false);

    conf.AddOptionsConfigfile(config);
    conf.AddOptionsConfigfile(sections);
    conf.AddOptionsConfigfile(hidden, false);

    conf.AddOptionsEnvironment(env);

    conf.AddOptionsDatabase(config);

    conf.SetArgumentPositions(p);
}

Here is the call graph for this function:

Here is the caller graph for this function: