separate and document FlyAwayOnIdle
document ReturnOnIdle
Merge pull request #6038 from Mailaender/idle-fly-doc

Documented FlyAwayOnIdle and ReturnOnIdle