Project

Profile

Help

Bug #3881

closed

Javadoc for lower bounded wildcard generic type

Added by Debbie Lockett over 5 years ago. Updated over 5 years ago.

Status:
Closed
Priority:
Low
Category:
Documentation
Sprint/Milestone:
-
Start date:
2018-08-21
Due date:
% Done:

100%

Estimated time:
Legacy ID:
Applies to branch:
9.8, trunk
Fix Committed on Branch:
9.8, trunk
Fixed in Maintenance Release:
Platforms:

Description

The Saxon documentation viewer app javadoc currently does not handle Java lower bounded wildcard generic types properly (e.g. <? super A>). For example, see the constructor and getNodeWrappingFunction method for NodeWrappingAxisIterator (http://www.saxonica.com/documentation/index.html#!javadoc/net.sf.saxon.tree.iter/NodeWrappingAxisIterator). The signature for the getNodeWrappingFunction method says

"public NodeWrappingFunction< B, NodeInfo> getNodeWrappingFunction ()"

but it should be

"public NodeWrappingFunction<? super B,NodeInfo> getNodeWrappingFunction()"

as in the HTML javadoc.

The problem was discovered while working on the javadoc for 9.9, where these generics are used more widely. It appears that in 9.8, the only place they are used is in NodeWrappingAxisIterator, so it's not surprising that the problem was missed up to now.

Please register to edit this issue

Also available in: Atom PDF