Detect and report limitation where .gz and .bz2 filenames can't contain single quotes
docs: improve map examples