fixes to all platfroms and to docs