add defaults for generator length
update formatting, phpdoc blocks
set defaults from parameters
handle CharactersNotFoundException