Outdated API documentation

[Christoph142]

trafficstars

Documentation is missing information about various APIs, like notifications and all of the ones introduced in Opera 28.

[shwetank]

We're working on it @Christoph142 .... Will be there soon.

[Christoph142]

OK. While we're at it: Could you please not only copy Chrome's documentation for notifications, but provide specific information about which icon sizes are used in which operating systems as Opera uses native ones? Cause we weren't conclusive about what to use (see https://github.com/Christoph142/DownloadControl/pull/3#issuecomment-70624483).

[shwetank]

Sure thing, thanks for pointing it out.

[Christoph142]

:+1:

[Christoph142]

Well, documentation was changed drastically. Stil that information is missing completely... It also doesn't mention that buttons are not supported in notifications at all.

[Christoph142]

ping @shwetank

[shwetank]

Hi @Christoph142 ... I was just checking this internally with others.

Regarding Windows and Linux we use 80x80 size. All icons are scaled to this size (with preserving proportions so it will not be stretched). But the size was set with the recent bugfix which is not on the stable build yet. The stable has currently 80x80 frame and 40x40 image inside.

Regarding Mac we use system messenger and the size is determined by the system. We use the following system function https://developer.apple.com/library/mac/documentation/Foundation/Reference/NSUserNotification_Class/index.html#//apple_ref/occ/instp/NSUserNotification/contentImage which doesn't determine any specific size.

I'll be updating the docs soon about this.