Change method signature from `updateEntireIndex:` to `updatePathspecs:`

While we’re at it:
- Change the ordering of the method parameters and block.
- Change block type to BOOL.
- Add a `BOOL *stop` parameter to the block.
Block cannot be nil.
Update documentation