add documentation and remove %i instances which are not compatible with 1.9.3 and backports