Fix important bug in screen clearing code, Beefed up API example in manpage.