Documentation missing template type in inherited classes

[andersjohnsen]

A HttpRequest in dart:io is defined as:

  abstract class HttpRequest implements Stream<List<int>> {

but the dartdoc days:

  Implements: Stream Extends: Object

https://api.dartlang.org/apidocs/channels/be/dartdoc-viewer/dart-io.HttpRequest

[lrhn]

Added Area-Pkg label.

[iposva-google]

The problem actually goes deeper. For example take a look at https://api.dartlang.org/apidocs/channels/be/dartdoc-viewer/dart-io.HttpServer#id_listen

This is the function definition listed:
StreamSubscription<T> listen(Function onData, {bool cancelOnError, Function onDone, Function onError})

There are multiple things wrong with this:

• The StreamSubscription should be properly typed here as there is no T type parameter within HttpRequest.
• Within the Stream class listen has the following parameter list:
    (void onData(T event), { Function onError, void onDone(), bool cancelOnError})
    You'll note that the first parameter is a typed function expecting a particular parameter type, but this gets dropped in the documentation.

[iposva-google]

cc @sethladd.

[kevmoo]

Changed the title to: "Documentation missing template type in inherited classes".

[efortuna]

The function issue that Ivan mentions has been fixed

[efortuna]

Added Duplicate label.
Marked as being merged into #16145.