◄Summary►  ◄Notes►  ◄Example►  ◄Back►
──────────────────────────────────────────────────────────────────────────────
 
▀ The function fails if:
  - any element of the pathname does not exist.
  - the specified directory is also the current directory.
  - the specified directory contains any files.
  - [3.0+] the program is running on a network and the user running the
    program has insufficient access rights.
                                    -♦-