I've been already asked a couple of times about WebKitWebView::download-requested being never emitted, so I think it's worth clarifying what's going on in the signal's documentation. Patch attached.
Created attachment 30625 [details] downloadrequesteddoc.patch Improve documentation.
Comment on attachment 30625 [details] downloadrequesteddoc.patch r=me
Landed in r44113.