From: Karen Etheridge Date: Sat, 21 Jul 2012 14:58:56 +0000 (-0700) Subject: a bit of doc cleanup X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=e831a3933c9a47b82f7b6d721f21b414fc3e215c;p=p5sagit%2FLog-Contextual.git a bit of doc cleanup --- diff --git a/lib/Log/Contextual.pm b/lib/Log/Contextual.pm index e079a77..a421fb0 100644 --- a/lib/Log/Contextual.pm +++ b/lib/Log/Contextual.pm @@ -256,11 +256,11 @@ C you will be able to swap underlying loggers later. C chooses which logger to use based on L<< user defined Cs|/LOGGER CODEREF >>. Normally you don't need to know this, but you can take advantage of it when you -need to later +need to later. =item * Scalable -If you just want to add logging to your extremely basic application, start with +If you just want to add logging to your basic application, start with L and then as your needs grow you can switch to L or L or L or whatever else. @@ -271,7 +271,7 @@ abstract your logging interface so that logging is as painless as possible, while still allowing you to switch from one logger to another. It is bundled with a really basic logger, L, -but in general you should use a real logger instead of that. For something +but in general you should use a real logger instead. For something more serious but not overly complicated, try L (see L for example.) @@ -383,7 +383,7 @@ own C subclass as follows: Note the C<< $_[1] || >> in C. All of these methods are passed the values passed in from the arguments to the subclass, so you can -either throw them away, honor them, die on usage, or whatever. To be clear, +either throw them away, honor them, die on usage, etc. To be clear, if you define your subclass, and someone uses it as follows: use MyApp::Log::Contextual -default_logger => $foo, @@ -543,7 +543,7 @@ slurping up (and also setting C) all the C<@args> Anywhere a logger object can be passed, a coderef is accepted. This is so that the user can use different logger objects based on runtime information. -The logger coderef is passed the package of the caller the caller level the +The logger coderef is passed the package of the caller, and the caller level the coderef needs to use if it wants more caller information. The latter is in a hashref to allow for more options in the future.