Re: issue-#100 Review all the existing documentation
Posted: Fri Apr 08, 2016 9:19 am
In practice, the normal user does not need Log and for avoiding any confusing
why it exists the fold text is enough.
> Let's be honest. I do not think, that any time we would change the Log module.
When Log is promoted to a general purpose logging framework, it would need
some generalization. Currently it supports only a single logging device.
A general purpose logging framework would have to support multiple
logging devices side by side. I guess, this limitation in its design
is why it was kept private.
Also, StdLog directly writes to the log window, bypassing Log.
It is questionable if this behavior is appropriate in the context of a
general purpose logging framework.
Also, StdLog behaves slightly different with respect to buffering.
So, what I want to say is that things are not so simple as they may look like
at the beginning.
We are here in the process of reviewing the existing docu and for that
it is enough to clarify the meaning of Log by means of some folded text.
Everything else goes beyond this issue.
- Josef
why it exists the fold text is enough.
> Let's be honest. I do not think, that any time we would change the Log module.
When Log is promoted to a general purpose logging framework, it would need
some generalization. Currently it supports only a single logging device.
A general purpose logging framework would have to support multiple
logging devices side by side. I guess, this limitation in its design
is why it was kept private.
Also, StdLog directly writes to the log window, bypassing Log.
It is questionable if this behavior is appropriate in the context of a
general purpose logging framework.
Also, StdLog behaves slightly different with respect to buffering.
So, what I want to say is that things are not so simple as they may look like
at the beginning.
We are here in the process of reviewing the existing docu and for that
it is enough to clarify the meaning of Log by means of some folded text.
Everything else goes beyond this issue.
- Josef