Re: [boost] [log] init methods and named parameters

Subject: Re: [boost] [log] init methods and named parameters
From: Michael Caisse (boost_at_[hidden])
Date: 2010-02-27 18:16:09

Andrey Semashev wrote:
>
> Boost.Parameter is not suited well for run time parameter composition. 
> Perhaps, what you're looking for is better achieved with 
> init_from_stream or init_from_settings.
> _______________________________________________

Andrey -

Thanks for the response. Let me start with mentioning that I 
have initially found this library useful. The trivial logging
has satisfied many of my first usage patterns.

However, I am finding it very difficult to follow the documentation.
For example, the tutorial section is not complete enough
to fabricate a working example. Specifically, the lack
of header definitions has become mind numbing. If there was
some macro include boost/log/log.hpp or something when you are
starting out ... it would be very helpful.

For a specific illustration, "Setting up sinks" calls a utility named
init_log_to_file. It took me way too long to figure out which include file 
had this. I want to follow along in the tutorial and actually *try* the
examples myself.

Better yet, the documentation is generated via boostbook, utilize the
feature to pull code examples directly from real working code. 
(see spirit docs for examples) This approach makes it easy for the user 
to follow along the tutorial and also ensures that your code examples are 
indeed correct and without flaw. The tutorials can all be compiled and 
checked just like regressions.

And now for my latest documentation hiccup: init_from_stream and
init_from_settings both look promising. I pull up the docs and
take a look at each. I follow the basic_settings link. I poke around
some more..... and now I'm getting frustrated again. Where do I
find list of possible settings? Why isn't there a link in the docs
to give me a hint of where to go?

Thanks! I am looking forward to fully reviewing your library.

michael

-- 
----------------------------------
Michael Caisse
Object Modeling Designs
www.objectmodelingdesigns.com