move id filter documentation around
it's not nearly as useful as it might have been because basenames are officially not unique