Document strange behaviour with Inventory.addItem and use java terminology in javadocs.