Updating doc blocks in Debugger and CakeLog.

lib/Cake/Log/CakeLog.php

@@ -42,6 +42,19 @@
  * using CakeLogs's methods.  If you don't configure any adapters, and write to the logs
  * a default FileLog will be autoconfigured for you.
  *
+ * ### Configuring Log adapters
+ *
+ * You can configure log adapters in your applications `bootstrap.php` file.  A sample configuration
+ * would look like:
+ *
+ * `CakeLog::config('my_log', array('engine' => 'FileLog'));`
+ *
+ * See the documentation on CakeLog::config() for more detail.
+ *
+ * ### Writing to the log
+ *
+ * You write to the logs using CakeLog::write().  See its documentation for more information.
+ *
  * @package       Cake.Log
  */
 class CakeLog {
@@ -69,11 +82,7 @@ class CakeLog {
  *
  * Will configure a FileLog instance to use the specified path.  All options that are not `engine`
  * are passed onto the logging adapter, and handled there.  Any class can be configured as a logging
- * adapter as long as it implements a `write` method with the following signature.
- *
- * `write($type, $message)`
- *
- * For an explaination of these parameters, see CakeLog::write()
+ * adapter as long as it implements the methods in CakeLogInterface.
  *
  * @param string $key The keyname for this logger, used to remove the logger later.
  * @param array $config Array of configuration information for the logger