Add doxygen comments to itemdef.h

I've added doxygen comments to itemdef.h.  I also removed a few function declarations from IWritableItemDefManager since they are already declared in its parent (IItemDefManager).
You should use the wording "returns", "overwrites" and such in these. "will *" is just clumsy.