Improve layout and clarify / complete documentation for the yadif