Documented support for clearing all items in pillbox

And changed language to indicate that index and count are optional parameters on the removeItems method.  Resolves issue #689