i didn't look at the docs (oops), just the sources in

src/python/pants/engine

. the specific thing that i didn't get was that a product has exactly one subject and everything else in a select clause is a singleton