tree 7cfac539876d150bb4f3e3301ece14efc6cbf5a2
parent 50e47a729ff2f2f2fda39f95f3c0ba1cfbdd9174
author Rob Pike <r@golang.org> 1374539831 +1000
committer Rob Pike <r@golang.org> 1374539831 +1000
golang-hg 0f2497c445995a723cabd2f8abf016e9c2c3f2a1

present/dir.go: be more idiomatic when documenting boolean return values.
Phrases like "returns whether or not the image is opaque" could be
describing what the function does (it always returns, regardless of
the opacity) or what it returns (a boolean indicating the opacity).
Even when the "or not" is missing, the phrasing is bizarre.

Go with "reports whether", which is still clunky but at least makes
it clear we're talking about the return value.

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