parse_config_file should be mentioned in the How To

[Olaf van der Spek <OlafvdSpek@…>]

Hi,

po::store(po::parse_config_file(is, desc), vm);

The very useful parse_config_file function should be mentioned in the How To and in the examples.

[Vladimir Prus]

The multiple_sources example uses parse_config_file already. I'm not sure adding parse_config_file to howto makes sense, given that howtos are for specific tips and tricks. I agree that the list of possible sources is not very apparent, and this is something to be fixed.

[Olaf van der Spek <OlafvdSpek@…>]

But IMO the config file is more important and useful than the response file, so it seems a bit weird to have a how to for the response files but not for the config files.

[Olaf van der Spek <OlafvdSpek@…>]

I see parse_config_file being mentioned only once in the multiple sources sample and that's in text, not in code.

[Vladimir Prus]

Here part of multiple_sources.cpp:

        store(parse_config_file(ifs, config_file_options), vm);

so clearly it is used in the code. Am I missing something?

[Vladimir Prus]

Howto, almost by definition, is for relatively arcane usages, not the baseline usage.

[Olaf van der Spek <OlafvdSpek@…>]

so clearly it is used in the code. Am I missing something?

But that part isn't shown in the web page itself, is it?

Howto, almost by definition, is for relatively arcane usages, not the baseline usage.

That's fine, provided the baseline usage is also clearly explained. :)

[Vladimir Prus]

(In [38495]) Document config file support in more detail. Fixes #808. Fixes #1125.

[anonymous]

Replying to Olaf van der Spek <OlafvdSpek@…>:

Hi,

po::store(po::parse_config_file(is, desc), vm);

The very useful parse_config_file function should be mentioned in the How To and in the examples.

The boost 1.48 examples doesn't show this function and it should. It mentions it but the example isn't listed.