code review 7004050: runtime/debug: document that Stack is deprecated

runtime/debug: document that Stack is deprecated

Fixes issue 4070.

[rsc, 2012-12-22 22:20:05]

Hello golang-dev@googlegroups.com,

I'd like you to review this change to
https://code.google.com/p/go/

[bradfitz, 2012-12-22 22:22:28]

LGTM

On Sat, Dec 22, 2012 at 2:20 PM, <rsc@golang.org> wrote:

> Reviewers: golang-dev_googlegroups.com,
>
> Message:
> Hello golang-dev@googlegroups.com,
>
> I'd like you to review this change to
> https://code.google.com/p/go/
>
>
> Description:
> runtime/debug: document that Stack is deprecated
>
> Fixes issue 4070.
>
> Please review this at
https://codereview.appspot.**com/7004050/<https://codereview.appspot.com/7004...
>
> Affected files:
>   M src/pkg/runtime/debug/stack.go
>
>
> Index: src/pkg/runtime/debug/stack.go
> ==============================**==============================**=======
> --- a/src/pkg/runtime/debug/stack.**go
> +++ b/src/pkg/runtime/debug/stack.**go
> @@ -29,6 +29,8 @@
>  // For each routine, it includes the source line information and PC value,
>  // then attempts to discover, for Go functions, the calling function or
>  // method and the text of the line containing the invocation.
> +//
> +// This function is deprecated. Use package runtime's Stack instead.
>  func Stack() []byte {
>         return stack()
>  }
>
>
>

[rsc, 2012-12-22 22:24:30]

*** Submitted as https://code.google.com/p/go/source/detail?r=80cf79e46452 ***

runtime/debug: document that Stack is deprecated

Fixes issue 4070.

R=golang-dev, bradfitz
CC=golang-dev
https://codereview.appspot.com/7004050