Squashed commit of the following:

commit 39a4de6736029d404c43c7853a5b8b61a1102add
Author: Larry Hosken <lhosken@twitter.com>
Date:   Mon Mar 3 09:10:12 2014 -0800

    Wickman's excellent review feedback, now in comment form

commit b71908e60627438677d6ee6350bb59b28e08f5bc
Author: Larry Hosken <lhosken@twitter.com>
Date:   Fri Feb 28 12:56:55 2014 -0800

    docs: BUILD dictionary: suppress fewer phantoms, setup_py comment