improved docs; add script to $PATH by creating symlink in /usr/local/bin, not by editing $PATH