Fix #2537: nextSlave is given a list of slavebuilders, not slaves

This is a minor bug in the docs. Adding an example to help cover
the most common usecase of the nextSlave function.