so we are free to change behaviour later. API & documentation cleanup @pinto Can you check the comments please, whether they are correct? svn path=/trunk/playground/graphics/okular/; revision=610731