update documentation for the getMediaIndexByTime routine

per @dmlap request.