added headerdoc for public interface