add note to doco about path() resolving symlinks