Finalise project before submitting.

checked warnings with sonarqube.
provided api documentation.
Final tests with French and spanish texts
found bugs and provided workarounds for some of them. (see todo & fixme)