summaryrefslogtreecommitdiff
path: root/src/library/scala/util/logging/Logged.scala
blob: 34ef6831ef85817833169c1ffad09ee92117c08a (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
/*                     __                                               *\
**     ________ ___   / /  ___     Scala API                            **
**    / __/ __// _ | / /  / _ |    (c) 2003-2009, LAMP/EPFL             **
**  __\ \/ /__/ __ |/ /__/ __ |                                         **
** /____/\___/_/ |_/____/_/ | |                                         **
**                          |/                                          **
\*                                                                      */

// $Id$


package scala.util.logging

/** <p>
 *    Mixing in the class <code>Logged</code> indicates that a class provides
 *    support for logging. For instance, the developer of a library writes
 *  </p>
 *  <pre>
 *    <b>class</b> MyClass <b>with</b> Logged { /* do stuff, call log */ }
 *  </pre>
 *  <p>
 *    The user of the library instantiates:
 *  </p>
 *  <pre>
 *    <b>val</b> x = <b>new</b> MyClass() <b>with</b> ConsoleLogger
 *  </pre>
 *  <p>
 *    and the logging will be sent to the <a href="../../Console$object.html"
 *    target="contentFrame"><code>Console</code></a> object.
 *  </p>
 */
trait Logged {

  /** This method should log the message given as argument somewhere
   *  as a side-effect.
   *
   *  @param msg ...
   */
  def log(msg: String): Unit = {}
}