Pravidla pro uvádění anotací @throws v Nette

Zdarec.

Všiml jsem si (resp. můj PHPStorm, který řve, že chytám něco, co nikdo nevyhazuje… :-) ), že v některých případech jsou u metod uvedeny anotace @throws s exceptions, které daná metoda může vyhodit, ale jinde tomu tak není.

Pěkný příklad je třeba třída Image, kde metody fromFile a fromString mají anotace @throws uvedené úplně jinak:
https://github.com/…ls/Image.php#L138
https://github.com/…ls/Image.php#L161

Říkal jsem si, že pošlu PR s doplněním některých těch anotací, ale pak jsem si uvědomil, že vlastně nevím, jaká jsou v Nette pravidla pro jejich uvádění (a jestli je o to vůbec zájem).

Dotaz tedy zní: Kdy přesně a za jakých podmínek uvádět tyhle @throws anotace?

Díky za info.

Editoval Eda (17. 11. 2018 23:58)