search

phpDocumentor / fig-standards

Standards either proposed or approved by the Framework Interop Group
http://www.php-fig.org/
Other
360 stars 85 forks source link

License should be inherited as well. #100

Closed Fleshgrinder closed 6 years ago

Fleshgrinder commented 9 years ago

Currenlty @version, @author, and @copyright are always inherited. However, @license should be added to that list in my opinion.

See 6. Inheritance.

ashnazg commented 6 years ago

I think that @license was never made hereditary because of the possibility of my more strictly licensed class extending from a more loosely licensed class, and thus the potential for incorrect licensing to appear in documentation. That could be more of a Oh Crap issue than other unintentional tags appearing.

Ping @ondrejmirtes @muglug @neuro159 @mindplay-dk @GaryJones @mvriel @jaapio for opinions.

mvriel commented 6 years ago

I think that hereditary meta-tags are interesting as is and can induce unwanted side effects (such as the @author appearing in a file for which someone is not the author). If anything, I would prefer less hereditary tags :)

neuro159 commented 6 years ago

If anything, I would prefer less hereditary tags :)

so true!

ashnazg commented 6 years ago

Looks like a no-go.