javadocs
improved expansion of java.io.File to have the "~" char expanded to user.home