docs
add hostname filtering
rename --hostname to --host
fix documentation to match latest changes