Repository: phpDocumentor/phpDocumentor

Issue #1672: Incorrect relative URLs created by @link/@see when used as inline tags
Created: 2015-11-02T20:41:01Z
When using a inline @link or @see tag to reference a class or method, phpDocumentor 2.8.5 doesn't take the base URL into account and creates invalid relative URLs. The following phpDoc results in this method doc. Please note the invalid URLs for PicoPluginInterface in the method description. Inline tags referencing methods are broken, too (Example). This only happens when used as inline tags, also note the correct URLs in the See also section on the right.
    /**
     * Returns the instance of a named plugin
     *
     * Plugins SHOULD implement {@link PicoPluginInterface}, but you MUST NOT
     * rely on it. For more information see {@link PicoPluginInterface}.
     *
     * @see    Pico::loadPlugins()
     * @see    Pico::getPlugins()
     * @param  string           $pluginName name of the plugin
     * @return object                       instance of the plugin
     * @throws RuntimeException             thrown when the plugin wasn't found
     */

Duplicate issue #1726: Internal links created by `@see` are broken
Created: 2016-01-22T15:13:22Z
Using phpDocumentor2 version 2.8.5, most of the internal links created by @see or {@see} are unusable (absolute, missing, or contain backslashes etc):
namespace TheNS;

/** The class docu. */
class TheClass {

    /** @var int  A property description. */
    public $aProperty = 42;

    /**
     * The method summary.
     *
     * - {@see \TheNS\TheClass}
     * - {@see \TheNS\TheClass::$aProperty}
     * - {@see \TheNS\TheClass::aMethod()}
     * - {@see \TheNS\TheClass              the class}
     * - {@see \TheNS\TheClass::$aProperty  the property}
     * - {@see \TheNS\TheClass::aMethod()   the method}
     *
     * @see \TheNS\TheClass
     * @see \TheNS\TheClass::$aProperty
     * @see \TheNS\TheClass::aMethod()
     *
     * @see \TheNS\TheClass              the class
     * @see \TheNS\TheClass::$aProperty  the property
     * @see \TheNS\TheClass::aMethod()   the method
     */
    public function aMethod () {}
}
All six inline {@see} tags create links with absolute URLs: href="/classes/TheNS.TheClass.html", tested with the "clean" and "responsive" templates.
The next three @see links are missing from the docu, see issue #1079.
The last three @see links are OK in the "clean" template, but in the "responsive" template, the href attributes are %5CTheNS%5CTheClass, %5CTheNS%5CTheClass::aProperty, and %5CTheNS%5CTheClass::aMethod(), respectively. %5C is a backslash.
This goes for the documentation of non-namespaced files as well. It doesn't make a difference whether FQSENs are used or not.

Closing comment (2016-05-12T01:35:39Z): partially a dup of #1672 (clean template)
@frickenate, please don't report problems in random issues, always create a new issue for a new problem (otherwise it's nearly impossible for the phpDoc devs to track and fix the issues). Your additional remarks have nothing to do with @fi5er's issue. Just fyi, the issue with missing text links is a dup of #1670; I don't know anything about your second paragraph, please make sure it hasn't been reported yet using GitHub's search engine and open a new issue when necessary.