doc: note the relationship between realpath and readlink