Various refactoring and scaladoc

- Update acolyte dependency (improve specs checking conversion errors, based on qualified messages).
- Various (minor) refactoring.
- Add scaladocs.