summaryrefslogtreecommitdiff
path: root/src/text
diff options
context:
space:
mode:
authorRob Pike <r@golang.org>2018-10-11 13:21:54 +1100
committerRob Pike <r@golang.org>2018-10-11 02:32:47 +0000
commit9a9dc36f97bf57e186ab8183a27927abb9aecd61 (patch)
tree5e610b53dfa713c89f0aa52184c29bb7495aa23f /src/text
parentdaf6f254336844ad8cf538640d81f0193988b62a (diff)
downloadgo-git-9a9dc36f97bf57e186ab8183a27927abb9aecd61.tar.gz
text/template: explain that integer constants can overflow
This behavior is the same as in Go: constants can be coerced to int and whether overflow occurs depends on how big an int is, but this surprises people sometimes, so document it again here. Fixes #25833. Change-Id: I557995f1a1e8e871b21004953923d16f36cb9037 Reviewed-on: https://go-review.googlesource.com/c/141378 Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org>
Diffstat (limited to 'src/text')
-rw-r--r--src/text/template/doc.go4
1 files changed, 3 insertions, 1 deletions
diff --git a/src/text/template/doc.go b/src/text/template/doc.go
index 4b243067b0..0179dec5c3 100644
--- a/src/text/template/doc.go
+++ b/src/text/template/doc.go
@@ -142,7 +142,9 @@ An argument is a simple value, denoted by one of the following.
- A boolean, string, character, integer, floating-point, imaginary
or complex constant in Go syntax. These behave like Go's untyped
- constants.
+ constants. Note that, as in Go, whether a large integer constant
+ overflows when assigned or passed to a function can depend on whether
+ the host machine's ints are 32 or 64 bits.
- The keyword nil, representing an untyped Go nil.
- The character '.' (period):
.