test and document --ignore flag