phpDocumentor/phpDocumentor2 — pull request #821 by mvriel (2013-05-10 07:08:53+00:00)
Title: WIP: Move inheritance from Behaviours to Descriptors

During the development of the Descriptors was inheritance not included, this was an oversight during the development process.

This issue corrects that oversight by adding inheritance support to the Descriptors.

- [x] Inherit summary
- [x] Inherit description
- [ ] Use the inline `@inheritdoc` to augment the existing description
- [ ] NEW: If the inline `@inheritDoc` is the only element; inherit everthing from the parent DocBlock
- [x] Inherit `@package` for Classes and Interfaces
- [ ] Inherit `@subpackage` for Classes and Interfaces
- [ ] Inherit `@var` for properties and constants
- [ ] Inherit `@param` for methods unless an `@param` exists in the current DocBlock
- [x] Inherit `@author` in all DocBlocks
- [x] Inherit `@version` in all DocBlocks
- [x] Inherit `@copyright` in all DocBlocks
- [ ] Inherit `@method` for Classes and Interfaces
- [ ] Inherit `@property` for Classes and Interfaces
- [ ] Inherit `@property-read` for Classes and Interfaces
- [ ] Inherit `@property-write` for Classes and Interfaces
- [ ] Update Twig template to support inherited information
- [ ] Separate retrieval of Inherited methods from the getMethods into a separate getInheritedMethods call.

Please note that inheritance is only applied if the parent element has the same base package (first part) as the current element.