The doctool appears to ignore a "returns:" keyword description if there is a return type specification

[simonjb]

In util/docscripts/_browse.php the following code has a returns value of "Boolean". The text description of the "returns:" keyword is not present.

hasWaiRole: function(/*Element*/ elem){
    // summary: Determines if an element has a role.
    // returns: true if elem has a role attribute and false if not.
    if(elem.hasAttribute){
        return elem.hasAttribute("role"); // Boolean
    }else{
        return elem.getAttribute("role") ? true : false; // Boolean
    }
}

Is the behaviour that I am seeing a bug or is it expected? One solution would be for me to not use return type comments and only have a "returns:" keyword comment. However, the ​styleguide suggests that return type information not be placed in the "returns:" keyword. Maybe that should be updated?

[Neil Roberts]

Currently being worked on

[Neil Roberts]

Fixed in r12987. Return type/summary will be added to the theme on redesign shortly.