It's clearer to specify first the configuration file before dumping all the keys and available functions.

Point out that *by default* telescope uses XDG-style directories, but if ~/.telescope exists XDG is ignored. While here also use a shorter URL for the XDG spec and add it to the STANDARDS section of the manpage.

Use XDG-compliant paths unless ~/.telescope already exists. Provide a script to migrate to XDG-style directory for users who wish to do so.

When enabled with the -S (or --safe) flag, prevent telescope from writing files to the disk.