documentation for version 1.8 (current in master)