utils.bzl: improve doc strings
utils.bzl: improve doc strings

...to specify more precisely the assumptions and intended
use for those functions.

Fixes #7913.

Change-Id: I067490b21a3092f70673b0db12ba884b31924e13
PiperOrigin-RevId: 241537153

ButterflyNetwork/bazel,dslomov/bazel,perezd/bazel,katre/bazel,ButterflyNetwork/bazel,ulfjack/bazel,safarmer/bazel,cushon/bazel,aehlig/bazel,cushon/bazel,akira-baruah/bazel,twitter-forks/bazel,ulfjack/bazel,davidzchen/bazel,meteorcloudy/bazel,werkt/bazel,dslomov/bazel,safarmer/bazel,ButterflyNetwork/bazel,werkt/bazel,aehlig/bazel,bazelbuild/bazel,davidzchen/bazel,dslomov/bazel,cushon/bazel,werkt/bazel,safarmer/bazel,meteorcloudy/bazel,twitter-forks/bazel,dslomov/bazel-windows,akira-baruah/bazel,ButterflyNetwork/bazel,werkt/bazel,akira-baruah/bazel,katre/bazel,cushon/bazel,ButterflyNetwork/bazel,akira-baruah/bazel,ulfjack/bazel,dslomov/bazel-windows,aehlig/bazel,katre/bazel,aehlig/bazel,meteorcloudy/bazel,cushon/bazel,safarmer/bazel,meteorcloudy/bazel,twitter-forks/bazel,aehlig/bazel,perezd/bazel,katre/bazel,dslomov/bazel-windows,dslomov/bazel-windows,meteorcloudy/bazel,ulfjack/bazel,twitter-forks/bazel,werkt/bazel,ulfjack/bazel,akira-baruah/bazel,aehlig/bazel,perezd/bazel,safarmer/bazel,ButterflyNetwork/bazel,dslomov/bazel,bazelbuild/bazel,katre/bazel,perezd/bazel,bazelbuild/bazel,perezd/bazel,aehlig/bazel,bazelbuild/bazel,davidzchen/bazel,perezd/bazel,dslomov/bazel,safarmer/bazel,dslomov/bazel-windows,dslomov/bazel-windows,perezd/bazel,meteorcloudy/bazel,twitter-forks/bazel,bazelbuild/bazel,davidzchen/bazel,katre/bazel,cushon/bazel,dslomov/bazel,davidzchen/bazel,ulfjack/bazel,bazelbuild/bazel,twitter-forks/bazel,akira-baruah/bazel,davidzchen/bazel,davidzchen/bazel,twitter-forks/bazel,ulfjack/bazel,dslomov/bazel,meteorcloudy/bazel,werkt/bazel