This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 20005 - suppress default method return value
Summary: suppress default method return value
Status: NEW
Alias: None
Product: webplatform.org
Classification: Unclassified
Component: infrastructure (show other bugs)
Version: unspecified
Hardware: PC All
: P2 normal
Target Milestone: ---
Assignee: Doug Schepers
QA Contact: public-webplatform-bugs list
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2012-11-19 15:41 UTC by Mike Sierra
Modified: 2012-11-19 15:41 UTC (History)
1 user (show)

See Also:


Attachments

Description Mike Sierra 2012-11-19 15:41:29 UTC
See:
http://docs.webplatform.org/wiki/apis/css-regions/Region/getRegionFlowRanges

...which displays this text under "Return Value":

 Returns an object of type function.

 Returns a series of Range objects that represent the fragments of DOM content that currently flow into the region.

The first "Returns" is auto-generated based on the interface member's identity as a method, and the second is content I wrote.  I'd think the reader only wants the return value of obj.method(). The fact that obj.method returns a reference to the function seems pointlessly obvious.  You shouldn't have to write the content pedantically as "When called as a method, returns..."