JAVADOC: Document rather strange behaviour in Inventory.addItem and use ...

...Java terminology for Java