Explain deprecated-aliases option (closes #47)
Fix utf-8 headers
Update documentation