From: Rob Pike <r@golang.org>
Date: Fri, 8 May 2009 22:55:45 +0000 (-0700)
Subject: Document runtime functions.
X-Git-Tag: weekly.2009-11-06~1671
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=4f211612690965c3a9cd5362257fcac346f41c60;p=gostls13.git

Document runtime functions.

R=rsc
DELTA=25  (25 added, 0 deleted, 0 changed)
OCL=28574
CL=28580
---

diff --git a/src/lib/runtime/runtime.go b/src/lib/runtime/runtime.go
new file mode 100644
index 0000000000..e3cf54c7f1
--- /dev/null
+++ b/src/lib/runtime/runtime.go
@@ -0,0 +1,26 @@
+// Copyright 2009 The Go Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style
+// license that can be found in the LICENSE file.
+
+/*
+	The runtime package contains operations that interact with Go's runtime system,
+	such as functions to control goroutines.
+ */
+package runtime
+
+// Gosched yields the processor, allowing other goroutines to run.  It does not
+// suspend the current goroutine, so execution resumes automatically.
+func	Gosched()
+
+// Goexit terminates the goroutine that calls it.  No other goroutine is affected.
+func	Goexit()
+
+// Breakpoint() executes a breakpoint trap.
+func	Breakpoint()
+
+// Caller reports file and line number information about function invocations on
+// the calling goroutine's stack.  The argument is the number of stack frames to
+// ascend, with 1 identifying the the caller of Caller.  The return values report the
+// program counter, file name, and line number within the file of the corresponding
+// call.  The boolean ok is false if it was not possible to recover the information.
+func	Caller(n int) (pc uint64, file string, line int, ok bool)