various display docs fixes & improvements