document some cross platform errors