path/filepath: document Dir better

This comment matches the one in path.

Fixes issue 4837.

R=golang-dev, bradfitz
CC=golang-dev
https://codereview.appspot.com/7305100