added docs; preserve return value of consumer; make wait queue anonymous
added docs; preserve return value of consumer; make wait queue anonymous

bosshy/hop_hop,bosshy/hop_hop,experteer/hop_hop,experteer/hop_hop