improved documentation - & added failing test

* path-for doesn't return what it should when you
	are using "meta" item-types