diff --git a/doc/manual/index.docbook b/doc/manual/index.docbook
index 79fc6859..93dd9a92 100644
--- a/doc/manual/index.docbook
+++ b/doc/manual/index.docbook
@@ -342,6 +342,46 @@ on the Mouse tab in the profile settings dialog.
+
+Semantic Shell Integration
+
+A shell program running in Konsole may emit escape sequences that partition the text
+displayed into three types: shell prompt, user input and command output. Using this semantic information enables
+various enhancements in Konsole.
+
+
+
+&Ctrl;&Shift;PgUp
+and
+&Ctrl;&Shift;PgDown
+scroll up/down to previous/next command prompt.
+Visual hints: a line is displayed above each prompt, prompt colors are less intense,
+and output colors are more intense. This may be configured to never show, always show, or only when URL hints are shown.
+
+
+Context menu options
+Copy user input
+Copy command output
+Copy except prompt
+may be used to filter selection when it is copied to the clipboard.
+
+When selection is empty, copy to clipboard action copies the current input line if it is not empty,
+or the last output if there is no current input.
+
+Pressing Up/Down arrow when editing a long input, will instead place the cursor one line up/down by
+sending the appropriate number of Left/Right key events to the shell. Configurable in the profile settings.
+Clicking the mouse on text input will place the cursor in the clicked location. Configurable in the profile settings.
+
+
+
+
+Semantic shell integration needs to be setup in the shell.
+Pressing &Ctrl;&Alt;] will paste the necessary commands needed in bash.
+For other shells, such as fish, zsh, python, etc. consult the relevant program's documentation.
+
+
+
+