Documentation comments for NSString additions

Hi there,
I've added some doc comments for the rest of NSString's additions (tried to keep the coding style of existing doc plus a coherent vocabulary with Apple's relevant method documentation). I've also issued a little fix for a warning (NSSet's `-sample` was sending a `-sample` message to NSArray without an import of the category).

Cheers!