doc changes
fix problems reported in the mailing list about face rotation