Bukkit/Bukkit-JavaDoc — pull request #85 by Bionicrm (2014-04-19 01:48:59+00:00)
Title: Complete getCurrentItem() @return description

In addition to adding "slot" to "the item in the clicked", it may be helpful to state that empty slots return Air, while clicking outside the inventory returns null. (I've tested this to confirm)