Document strange behaviour of Inventory.addItem and use Java terminology for javadocs.