diff --git a/doc/config-pdf-digital-signatures.png b/doc/config-pdf-digital-signatures.png
new file mode 100644
index 000000000..1efe5d889
Binary files /dev/null and b/doc/config-pdf-digital-signatures.png differ
diff --git a/doc/index.docbook b/doc/index.docbook
index b687b042a..dbb6078d2 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -471,6 +471,29 @@ Context menu actions like Rename Bookmarks etc.)
This feature is available for &PDF; documents only. You need to install at least version 0.51 of Poppler to get most signature information, version 0.68 to get signature location/reason information, and version 0.73 to get signature certificate information.
+
+ Adding Digital Signatures
+
+ You can add digital signatures to documents using the corresponding action in the Tools menu.
+
+
+ To be able to sign a document you need to have a proper PKCS signing certificate available on your system. Okular does not have the ability to create such certificates since they need to be issued by certificate authorities to be useful for validation, &etc;
+
+
+ We use the Poppler library to handle signing of &PDF; documents and Poppler is using the NSS library to handle certificates. At the point of writing, Poppler will try to use the following NSS certificate stores in order (if they exist):
+
+ The current Firefox user certificate store.
+ The system-wide /etc/pki/nssdb certificate store.
+ The current user $HOME/.pki/nssdb
+
+ If you want to use a custom certificate store you can do so by setting it in the PDF Digital Signature Certificates section of the Configure Backends... dialog.
+
+
+
+ This feature is available for &PDF; documents only. You need to install at least version 21.01 of Poppler to be able to add digital signatures to a document.
+
+
+ Annotations
@@ -2185,6 +2208,17 @@ Context menu actions like Rename Bookmarks etc.)
section about Annotations.
+
+
+
+ Tools
+ Digitally Sign...
+
+
+
+ Starts the digital signature creation workflow. Addition of digital signatures is only supported for PDF files at this point. For more information, please see the section about Adding Digital Signatures.
+
+
@@ -2425,6 +2459,16 @@ Context menu actions like Rename Bookmarks etc.)
+
+
+ &PDF; Digital Signature Certificates
+
+
+ This section allows you to set a custom Certificate Database to use when adding Digital Signatures to &PDF; files.
+
+
+ It also lists the certificates available in the current Certificate Database (if any).
+