Fix for bug 870563 - Document panel positioning

I didn't add anything to the tutorial, as that uses Widget, so position won't work. But I added a section in the preamble and copy-edited the detailed API reference.