[doc] improved javadoc comment about path specificity