diff options
author | Rob Pike <r@golang.org> | 2010-10-17 09:20:23 -0700 |
---|---|---|
committer | Rob Pike <r@golang.org> | 2010-10-17 09:20:23 -0700 |
commit | 8abb8e1d20d2696f975e7074ce8d96d71d484a2b (patch) | |
tree | 2de97611d24041921baf33e759ab128586c3c1a2 | |
parent | 8052786e51f606ac201e92d288ed8d49069b71f4 (diff) | |
download | go-8abb8e1d20d2696f975e7074ce8d96d71d484a2b.tar.gz go-8abb8e1d20d2696f975e7074ce8d96d71d484a2b.zip |
log: update the documentation to clarify the behavior
R=rsc, PeterGo
CC=golang-dev
https://golang.org/cl/2519043
-rw-r--r-- | src/pkg/log/log.go | 29 |
1 files changed, 19 insertions, 10 deletions
diff --git a/src/pkg/log/log.go b/src/pkg/log/log.go index 50c01a3d35..ac24b4deaa 100644 --- a/src/pkg/log/log.go +++ b/src/pkg/log/log.go @@ -21,7 +21,7 @@ import ( "time" ) -// These flags define the output Loggers produce. +// These flags define which text to prefix to each log entry generated by the Logger. const ( // Bits or'ed together to control what's printed. There is no control over the // order they appear (the order listed here) or the format they present (as @@ -125,9 +125,12 @@ func (l *Logger) formatHeader(buf *bytes.Buffer, ns int64, calldepth int) { } } -// Output writes the output for a logging event. The string s contains the text to print after -// the time stamp; calldepth is used to recover the PC. It is provided for generality, although -// at the moment on all pre-defined paths it will be 2. +// Output writes the output for a logging event. The string s contains +// the text to print after the prefix specified by the flags of the +// Logger. A newline is appended if the last character of s is not +// already a newline. Calldepth is used to recover the PC and is +// provided for generality, although at the moment on all pre-defined +// paths it will be 2. func (l *Logger) Output(calldepth int, s string) os.Error { now := time.Nanoseconds() // get this early. buf := new(bytes.Buffer) @@ -140,15 +143,18 @@ func (l *Logger) Output(calldepth int, s string) os.Error { return err } -// Printf prints to the logger in the manner of fmt.Printf. +// Printf calls l.Output to print to the logger. +// Arguments are handled in the manner of fmt.Printf. func (l *Logger) Printf(format string, v ...interface{}) { l.Output(2, fmt.Sprintf(format, v...)) } -// Print prints to the logger in the manner of fmt.Print. +// Print calls l.Output to print to the logger. +// Arguments are handled in the manner of fmt.Print. func (l *Logger) Print(v ...interface{}) { l.Output(2, fmt.Sprint(v...)) } -// Println prints to the logger in the manner of fmt.Println. +// Println calls l.Output to print to the logger. +// Arguments are handled in the manner of fmt.Println. func (l *Logger) Println(v ...interface{}) { l.Output(2, fmt.Sprintln(v...)) } // SetOutput sets the output destination for the standard logger. @@ -168,17 +174,20 @@ func SetPrefix(prefix string) { // These functions write to the standard logger. -// Print prints to the standard logger in the manner of fmt.Print. +// Print calls Output to print to the standard logger. +// Arguments are handled in the manner of fmt.Print. func Print(v ...interface{}) { std.Output(2, fmt.Sprint(v...)) } -// Printf prints to the standard logger in the manner of fmt.Printf. +// Printf calls Output to print to the standard logger. +// Arguments are handled in the manner of fmt.Printf. func Printf(format string, v ...interface{}) { std.Output(2, fmt.Sprintf(format, v...)) } -// Println prints to the standard logger in the manner of fmt.Println. +// Println calls Output to print to the standard logger. +// Arguments are handled in the manner of fmt.Println. func Println(v ...interface{}) { std.Output(2, fmt.Sprintln(v...)) } |