This is not very clear. The doc block should explain what $path is and if this is a property of $path, it should be documented as well. In fact, OC\Preview\Provider has a completely incorrect doc block.