cmd/ld: document that -X overwrites initialized variables
Fixes #7626.
LGTM=iant
R=rsc, iant
CC=golang-codereviews
https://golang.org/cl/144870045
diff --git a/src/cmd/ld/doc.go b/src/cmd/ld/doc.go
index 8135bd5..5b5833d 100644
--- a/src/cmd/ld/doc.go
+++ b/src/cmd/ld/doc.go
@@ -63,9 +63,9 @@
-w
Omit the DWARF symbol table.
-X symbol value
- Set the value of an otherwise uninitialized string variable.
- The symbol name should be of the form importpath.name,
- as displayed in the symbol table printed by "go tool nm".
+ Set the value of a string variable. The symbol name
+ should be of the form importpath.name, as displayed
+ in the symbol table printed by "go tool nm".
-race
Link with race detection libraries.
-B value
diff --git a/test/linkx.go b/test/linkx.go
index 12d446f..36d16ae 100644
--- a/test/linkx.go
+++ b/test/linkx.go
@@ -1,4 +1,4 @@
-// $G $D/$F.go && $L -X main.tbd hello $F.$A && ./$A.out
+// $G $D/$F.go && $L -X main.tbd hello -X main.overwrite trumped $F.$A && ./$A.out
// NOTE: This test is not run by 'run.go' and so not run by all.bash.
// To run this test you must use the ./run shell script.
@@ -12,9 +12,13 @@
package main
var tbd string
+var overwrite string = "dibs"
func main() {
if tbd != "hello" {
- println("BUG: test/linkx", len(tbd), tbd)
+ println("BUG: test/linkx tbd", len(tbd), tbd)
+ }
+ if overwrite != "trumped" {
+ println("BUG: test/linkx overwrite", len(overwrite), overwrite)
}
}
