I would like to add markup documentation to a Swift function that is implemented owing to the fact that a class conforms to UICollectionViewDataSource
. For instance:
///
/// - returns: Why is this documentation ignored?
///
override func collectionView(collectionView: UICollectionView, numberOfItemsInSection section: Int) -> Int {
return 2
}
Apparently my comments are ignored and the generated documentation remains the one inherited from the contracts definition (or some other default location), for Quick Help (in Xcode 7.1.1) includes this text:
Returns The number of rows in section.
How can I "override" such a default documentation to call out changes in my implementation?