{"action":"reopened","issue":{"url":"https://api.github.com/repos/phpDocumentor/phpDocumentor2/issues/1665","labels_url":"https://api.github.com/repos/phpDocumentor/phpDocumentor2/issues/1665/labels{/name}","comments_url":"https://api.github.com/repos/phpDocumentor/phpDocumentor2/issues/1665/comments","events_url":"https://api.github.com/repos/phpDocumentor/phpDocumentor2/issues/1665/events","html_url":"https://github.com/phpDocumentor/phpDocumentor2/issues/1665","id":113493059,"number":1665,"title":"Support @path tag or support file paths in @see tags","user":{"login":"PhrozenByte","id":920356,"avatar_url":"https://avatars.githubusercontent.com/u/920356?v=3","gravatar_id":"","url":"https://api.github.com/users/PhrozenByte","html_url":"https://github.com/PhrozenByte","followers_url":"https://api.github.com/users/PhrozenByte/followers","following_url":"https://api.github.com/users/PhrozenByte/following{/other_user}","gists_url":"https://api.github.com/users/PhrozenByte/gists{/gist_id}","starred_url":"https://api.github.com/users/PhrozenByte/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/PhrozenByte/subscriptions","organizations_url":"https://api.github.com/users/PhrozenByte/orgs","repos_url":"https://api.github.com/users/PhrozenByte/repos","events_url":"https://api.github.com/users/PhrozenByte/events{/privacy}","received_events_url":"https://api.github.com/users/PhrozenByte/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":4,"created_at":"2015-10-27T02:36:05Z","updated_at":"2015-12-02T18:01:03Z","closed_at":null,"body":"Sometimes it's useful to reference certain files or directories (generally: paths) in the code documentation. Currently this isn't possible with phpDocumentor, the `@path` tag isn't supported and the `@see` tag isn't designed to be used with paths. phpDocumentor should either support the `@path` tag or extend the `@see` tag to understand paths (the first solution probably is easier to implement, but the latter is more generic).\r\n\r\nA example from the upcoming [Pico 1.0](https://github.com/picocms/Pico):\r\n```php\r\n    /**\r\n     * Sets Picos config before calling Pico::run()\r\n     *\r\n     * This method allows you to modify Picos config without creating a\r\n     * {@path \"config/config.php\"} or changing some of its variables before\r\n     * Pico starts processing. It can only be called between the constructor\r\n     * call and Pico::run(). Options set with this method cannot be overwritten\r\n     * by {@path \"config/config.php\"}.\r\n     *\r\n     * @param  mixed[] $config  array with configuration variables, like\r\n     *     $config in {@path \"config/config.php\"}\r\n     * @return void\r\n     * @throws RuntimeException thrown if Pico already started processing\r\n     */\r\n    public function setConfig(array $config)\r\n    {\r\n        // ...\r\n    }\r\n```"}}