Tests, documentation for new add() method.