add HEREDOC hack
update documentation