Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Plugin documentation generator - add support for inline tag link #4242

Closed
tsteur opened this issue Oct 26, 2013 · 3 comments
Closed

Plugin documentation generator - add support for inline tag link #4242

tsteur opened this issue Oct 26, 2013 · 3 comments
Labels
Enhancement For new feature suggestions that enhance Matomo's capabilities or add a new report, new API etc.
Milestone

Comments

@tsteur
Copy link
Member

tsteur commented Oct 26, 2013

It would be nice to easily link to other classes & methods within those classes. {@link ... ...} and @see, neither worked. markdown syntax works, but this will become unreadable when reading the docs in code.

@tsteur
Copy link
Member Author

tsteur commented Oct 27, 2013

From what I see Sami does not support inline tags and it would be probably a few or more days work to support it.

FYI: What should work is @link and @see on docblock level: FriendsOfPHP/Sami#8

@tsteur
Copy link
Member Author

tsteur commented Dec 2, 2013

Added {@link destination [description]} support in Class, Property, Method and Constant comments. The following links work so far:

 * {@link Map}  // class within this namespace
 * {@link Piwik\DataTable\Map}  // full classname
 * {@link getKeyName()}   // method within this class
 * {@link $myproperty}    // property within this class
 * {@link Map::getKeyName()} // method from any class
 * {@link Map::$myproperty}  // property from any class
 * {@link http://piwik.org}  // http link
 * {@link https://piwik.org} // https link
 * {@link mailto:test}       // mailto link


 * {@link Map Description Text}  // class within this namespace
 * {@link Piwik\DataTable\Map Description Text}  // full classname
 * {@link getKeyName() Description Text}   // method within this class
 * {@link $myproperty Description Text}    // property within this class
 * {@link Map::getKeyName() Description Text} // method from any class
 * {@link Map::$myproperty Description Text}  // property from any class
 * {@link http://piwik.org Description Text}  // http link
 * {@link https://piwik.org Description Text} // https link
 * {@link mailto:test Description Text}       // mailto link


 * {@link NotExistingClass}
 * {@link Piwik\DataTable\NotExistingClass}
 * {@link notExistingInternalMethod()}
 * {@link $notExistingInternalProperty}
 * {@link Map::notExistingExternalMethod()}
 * {@link NotExistingClass::notExistingExternalMethod()}
 * {@link Map::$notExistingProperty}
 * {@link NotExistingClass::$notExistingMethod}


 * {@link NotExistingClass Description}
 * {@link Piwik\DataTable\NotExistingClass Description}
 * {@link notExistingInternalMethod() Description}
 * {@link $notExistingInternalProperty Description}
 * {@link Map::notExistingExternalMethod() Description}
 * {@link NotExistingClass::notExistingExternalMethod() Description}
 * {@link Map::$notExistingProperty Description}
 * {@link NotExistingClass::$notExistingMethod Description}

@tsteur
Copy link
Member Author

tsteur commented Dec 3, 2013

This issue was closed.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Enhancement For new feature suggestions that enhance Matomo's capabilities or add a new report, new API etc.
Projects
None yet
Development

No branches or pull requests

1 participant