char: document the functions that will be the public interface