added doc strings to public functions
use a more standard designator for no-break_space (github issue:9)