diff --git a/doc/index.docbook b/doc/index.docbook
index 70b9364ce..1f2236e5f 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -488,7 +488,249 @@ Context menu actions like Rename Bookmarks etc.)
its buttons or use keyboard shortcuts (keys from 1 to 9) to start constructing that annotation.
- The contents of the annotating toolbar can be configured using the Annotations page of &okular; configuration dialog. This page can be opened with &RMB; clicking on the annotating toolbar then choosing Configure Annotations... from the context menu.
+ The annotating toolbar helps you to make annotations with drawings, shapes, and text messages. You can use the annotating toolbar to mark up a document (⪚ add lines, ellipses, polygons, stamps, highlights, underlines &etc;). The table below describes exactly what the default set of annotating toolbar buttons does.
+
+
+
+
+
+
+ Button
+
+
+ Tool Name
+
+
+ Description
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Pop-up Note
+
+
+
+
+ To draw multiline note. The note will can be viewed by double clicking on an icon in the document.
+
+
+ Click on the tool button, then click on the place in the document where the pop-up note should be added. Enter the text of pop-up note then click on the Close this note button in the top right corner of the pop-up window.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Inline Note
+
+
+
+
+ To draw inline note. The note will be shown inline as is.
+
+
+ Click on the tool button, then click with the &LMB; and hold to place the top-left corner of the note, then drag to place the bottom-right one. Enter the text of the note then click on the OK to save the note, Cancel to cancel note entering or Clear to clear the note.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Freehand Line
+
+
+
+
+ To draw free-form lines.
+
+
+ Click on the tool button, then click with the &LMB; and hold to place the start of the line, then drag to draw the line.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Highlighter
+
+
+
+
+ To highlight text in the document with some given background color.
+
+
+ Click on the tool button, then click with the &LMB; and hold to place the beginning of the highlighted text snippet, then drag to highlight it.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Straight Line
+
+
+
+
+ To mark with a line.
+
+
+ Click on the tool button, then click with the &LMB; to place the starting point of the line, then drag to place of the ending point of the line should be and click once more.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Polygon
+
+
+
+
+ To draw a closed plane figure from three or more segments. The corresponding note can be viewed by double clicking inside the polygon.
+
+
+ Click on the tool button, then click with the &LMB; to place the first vertex of the polygon, then drag to place of the second vertex. Proceed until you draw the whole polygon up to the first vertex. Click twice if you want to add some note to the polygon. Enter the text of the note then click on the OK to save the note, Cancel to cancel note entering or Clear to clear the note.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Stamp
+
+
+
+
+ To mark the text or image with some predefined shape.
+
+
+ Click on the tool button then click with the &LMB; to place the stamp.
+
+
+ A single click just places a square stamp (useful for icons).
+ To add a rectangular stamp you can click with the &LMB; and hold to place the top-left point, then drag to place the bottom-right one.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Underline
+
+
+
+
+ To underline some text.
+
+
+ Click on the tool button, then click with the &LMB; and hold to place the beginning of the underlined text snippet, then drag to underline it.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Ellipse
+
+
+
+
+ To draw an ellipse around some chosen area.
+
+
+ Click on the tool button, then click with the &LMB; and hold to place the top-left corner of the circumscribed rectangular for the ellipse, then drag to place the bottom-right one.
+
+
+
+
+
+
+
+ The contents of the annotating toolbar can be configured using the Annotations page of &okular; configuration dialog. This page can be opened with &RMB; clicking on the annotating toolbar then choosing Configure Annotations... from the context menu.
With a single &LMB; click on an annotation tool button you can use a tool once.
@@ -516,11 +758,6 @@ Context menu actions like Rename Bookmarks etc.)
Annotations page in &okular;s
configuration dialog. The Annotations page can also be used to configure the content of the annotating toolbar.
-
- Using stamps a single click just places a square stamp (useful for icons).
- To add a rectangular stamp you can click with the &LMB; and hold to place the top-left point,
- then drag to place the bottom-right one.
- Removing annotations
diff --git a/doc/tool-ellipse-okular.png b/doc/tool-ellipse-okular.png
new file mode 100644
index 000000000..82d1d18a8
Binary files /dev/null and b/doc/tool-ellipse-okular.png differ
diff --git a/doc/tool-highlighter-okular.png b/doc/tool-highlighter-okular.png
new file mode 100644
index 000000000..4a46158fc
Binary files /dev/null and b/doc/tool-highlighter-okular.png differ
diff --git a/doc/tool-ink-okular.png b/doc/tool-ink-okular.png
new file mode 100644
index 000000000..16f2b886a
Binary files /dev/null and b/doc/tool-ink-okular.png differ
diff --git a/doc/tool-line-okular.png b/doc/tool-line-okular.png
new file mode 100644
index 000000000..e4f2d8251
Binary files /dev/null and b/doc/tool-line-okular.png differ
diff --git a/doc/tool-note-inline-okular.png b/doc/tool-note-inline-okular.png
new file mode 100644
index 000000000..235d0a446
Binary files /dev/null and b/doc/tool-note-inline-okular.png differ
diff --git a/doc/tool-note-okular.png b/doc/tool-note-okular.png
new file mode 100644
index 000000000..b0dd4635c
Binary files /dev/null and b/doc/tool-note-okular.png differ
diff --git a/doc/tool-polygon-okular.png b/doc/tool-polygon-okular.png
new file mode 100644
index 000000000..9df96ca12
Binary files /dev/null and b/doc/tool-polygon-okular.png differ
diff --git a/doc/tool-stamp-okular.png b/doc/tool-stamp-okular.png
new file mode 100644
index 000000000..1bbd2688b
Binary files /dev/null and b/doc/tool-stamp-okular.png differ
diff --git a/doc/tool-underline-okular.png b/doc/tool-underline-okular.png
new file mode 100644
index 000000000..a14282d1f
Binary files /dev/null and b/doc/tool-underline-okular.png differ