commit ec90a26f46ce2223c965cbe1eb6a7841e01bd98d
author Rob Pike <r@golang.org> Tue Jul 23 10:37:11 2013 +1000
committer Rob Pike <r@golang.org> Tue Jul 23 10:37:11 2013 +1000
tree 7cfac539876d150bb4f3e3301ece14efc6cbf5a2
parent 50e47a729ff2f2f2fda39f95f3c0ba1cfbdd9174

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