From: Rob Pike <r@golang.org>
Date: Fri, 17 Feb 2012 01:47:56 +0000 (+1100)
Subject: debug/dwarf: address TODO in doc comment for New
X-Git-Tag: weekly.2012-02-22~173
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=a15f59ef1da4c3ac23e46eef2fa679e0f41205bb;p=gostls13.git

debug/dwarf: address TODO in doc comment for New

Fixes #2844.

R=golang-dev, dsymonds
CC=golang-dev
https://golang.org/cl/5675072
---

diff --git a/src/pkg/debug/dwarf/open.go b/src/pkg/debug/dwarf/open.go
index 9543297e18..37a518b6d3 100644
--- a/src/pkg/debug/dwarf/open.go
+++ b/src/pkg/debug/dwarf/open.go
@@ -31,8 +31,9 @@ type Data struct {
 }
 
 // New returns a new Data object initialized from the given parameters.
-// Clients should typically use [TODO(rsc): method to be named later] instead of calling
-// New directly.
+// Rather than calling this function directly, clients should typically use
+// the DWARF method of the File type of the appropriate package debug/elf,
+// debug/macho, or debug/pe.
 //
 // The []byte arguments are the data from the corresponding debug section
 // in the object file; for example, for an ELF object, abbrev is the contents of