Moved character references and examples from comments to docs; fixes #122