make ref wave black if it's included, improve docs

this better matches the behavior of the object wave