<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type">
</head>
<body text="#330033" bgcolor="#ffffff">
On 12/10/2010 12:06 AM, Vinay Sajip wrote:
<blockquote cite="mid:loom.20101210T085332-877@post.gmane.org"
type="cite">
<blockquote type="cite" style="color: rgb(0, 0, 0);">
<pre wrap=""><span class="moz-txt-citetags">> </span>This simplistic easy usage somewhat echo's Glenn's comment on this thread
</pre>
</blockquote>
<pre wrap="">about logging seeming way to daunting as presented today. It needn't be.
</pre>
<blockquote type="cite" style="color: rgb(0, 0, 0);">
<pre wrap=""><span class="moz-txt-citetags">> </span>
</pre>
</blockquote>
<pre wrap="">Indeed, and the very first code sample in the logging documentation shows
exactly the simplistic easy usage you're talking about. I can't see why anyone
would be scared off by that example.
</pre>
</blockquote>
<br>
It didn't scare me off. But it wasn't _quite_ comprehensive enough
to keep me from being put off by the next bit of manual, (about 8%,
as mentioned before), which had lots of discussion, but no more
examples, so what is lacking up front is a few more examples of
using the convenience methods as Greg apparently does, without
configuration, but showing use in multiple modules. After it is
shown to be simple to get started in a multi-module code base, then
all the refinements can be explained and added, but by then people
are already using the logger, and learning becomes incremental.<br>
<br>
Otherwise, people are scared off or put off by the need to learn
lots of new terms (logger, filter, handler, formatter, and
configuration) before they get any value out of it.<br>
<br>
The next thing after the simple example is a rotating log
configuration. A handy feature, of course, but hardly the second
thing that one needs to learn about logging. Maybe the 4th or 5th
or later.<br>
</body>
</html>