add note to doco about path() resolving symlinks

I found this behaviour unexpected, so here's a doc-patch. Note that the patch also deletes META.yml. This shouldn't be in the repo as it is supposed to be generated by your Makefile.PL and bundled with the distribution when you 'make dist'.