lua : document the new yield function
usermanual : add a section about yielding in lua