update interface docs to make attributes return int (per irc discussion)