return value of reponse-starter callback passed for streaming is not defined

[markstos]

The docs say this "MAY return a callback that is passed another callback (response starter) as its first argument, and pass the three element response to the callback."

The return value of the "response starter" callback does not appear to be defined. (Or perhaps there definition is in there somewhere, but needs to be clarified).

Thanks.

[miyagawa]

It's explained in the very next paragraph.

[markstos]

This paragraph: "Similarly, an application MAY omit the third element (the body) in the callback to get a response writer object, that implements write, poll_cb and close method to push the response body."

So, the return value is the three element response, where the third value may be omitted to become a response writer?

The return value is only implied in the definition here. It sounds like it should be: "The interior callback should return the standard three element response. An application MAY omit..."

[miyagawa]

So, the return value is the three element response, where the third value may be omitted to become a response writer?

No.

[miyagawa]

If the callback is given three elements, the return value of the callback is "undefined" i.e. thrown away.

If the callback is given two elements (i.e. the third element is omitted) the callback should return a writer object that implements write and close. (No poll_cb here anymore, you're reading the wrong version of the document).