Logging documentation is confusing #886
I have looked at http://stellar.cct.lsu.edu/files/hpx_0.9.6/html/hpx/manual/init/logging.html, and I find this page is quite confusing. It discusses the "init file format" and even points to another page describing this, without saying what file this or where it should be located.
The table with logging levels and "integral values" is also strange. Presumably, one has to set an environment variable to the particular integral value to set the respective logging level.
The page speaks of "environmental variables in the main HPX ini file". I assume I can just set an environment variable for this, without knowing where this "main HPX ini file" is located or how to create it. This should be stated explicitly.
The statement "the syntax and means of setting environment variables varies between operating systems" is not helpful. The two main Unix syntaxes (sh and csh, via "export var=value" and "setenv var value" could be mentioned here, or there could be pointers to other places describing this.
I assume that you will be asking users to switch on logging to help them debug problems. In this case, it should be most useful to have an example there.