diff --git a/doc/enhance-lowcontrast.png b/doc/enhance-lowcontrast.png
new file mode 100644
index 000000000..da7d9e0c6
Binary files /dev/null and b/doc/enhance-lowcontrast.png differ
diff --git a/doc/enhance-shape.png b/doc/enhance-shape.png
new file mode 100644
index 000000000..412ef540c
Binary files /dev/null and b/doc/enhance-shape.png differ
diff --git a/doc/enhance-solid.png b/doc/enhance-solid.png
new file mode 100644
index 000000000..a5dcf8597
Binary files /dev/null and b/doc/enhance-solid.png differ
diff --git a/doc/enhance-thinline.png b/doc/enhance-thinline.png
new file mode 100644
index 000000000..daab11b86
Binary files /dev/null and b/doc/enhance-thinline.png differ
diff --git a/doc/index.docbook b/doc/index.docbook
index 538f71f80..55bb07951 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -1535,15 +1535,88 @@ Add a 'Find Previous' entry
Drawing lines in &okular; is implemented in two steps: generation of the clipping path and filling this clipping path. When the line in the original document is less than one pixel this two step implementation could cause problems. For those lines, the clipping path is filled with the filling color that depends on the thickness of the line part inside the clipping area. If the part of the line inside the clipping area gets very small the contrast between the shape and the background color can become too low for the line to be recognizable. The grids of such lines then looks very unpretty.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Thin line (red), its clipping path (dashed line) and pixel boundaries (black solid lines)
+ Thin line shown at a low contrast
+
+
+
+
To enhance the look of the thin lines &okular; implements two options.
- The first option is Solid. With this option &okular; adjusts clipping path and line position so that clipping path and line are on the same pixel boundary, &ie; &okular; enlarges the thin lines to one pixel on the output device. This mode is similar to the Enhance thin lines in Adobe Reader. If this option is chosen, the thin lines are always enlarged.
+ The first option is Solid. With this option &okular; adjusts clipping path and line position so that clipping path and line are on the same pixel boundary, &ie; &okular; enlarges the thin lines to one pixel on the output device. This mode is similar to the Enhance thin lines in Adobe
+ Reader. If this option is chosen, the thin lines are always enlarged.
+
+
+
+
+
+
+
+
+
+
+ Thin line with Solid enhancement
+
+
+ Thin line with Solid enhancement
+
+
+
The second option is Shape. With this option the clipping path and line are adjusted to pixel boundary as well, but the line intensity is corrected according to its width.
+
+
+
+
+
+
+
+
+
+ Thin line with Shape enhancement
+
+
+ Thin line with Shape enhancement
+
+
+
+
The thin lines are not enhanced by default (option No).
@@ -1552,6 +1625,7 @@ Add a 'Find Previous' entry
+
Configuring &okular;
diff --git a/doc/rating.png b/doc/rating.png
deleted file mode 100644
index 3630d8ff1..000000000
Binary files a/doc/rating.png and /dev/null differ