Add more documentation for LimitQueue.Add()

Also subtly modifies the return value meaning depending on the
limit strategy used.