#3163 doc: add script function documentation

Signed-off-by: Patrizio Bekerle <patrizio@bekerle.com>

src/services/scriptingservice.cpp

@@ -2149,6 +2149,15 @@ QString ScriptingService::inputDialogGetMultiLineText(const QString &title, cons
 #endif
 }
 
+/**
+ * Opens a dialog to show the differences between two texts and lets the user edit the result
+ *
+ * @param title {QString} title of the dialog
+ * @param label {QString} label text of the dialog
+ * @param text1 {QString} first text
+ * @param text2 {QString} second text
+ * @return
+ */
 QString ScriptingService::textDiffDialog(const QString &title, const QString &label,
                                       const QString &text1, const QString &text2) {
     MetricsService::instance()->sendVisitIfEnabled(QStringLiteral("scripting/") %

webpage/src/scripting/methods-and-objects.md

@@ -1651,6 +1651,37 @@ var result = script.inputDialogGetMultiLineText(
 script.log(result);
 ```
 
+Opening a dialog to show the differences between two texts
+----------------------------------------------------------
+
+### Method call and parameters
+```cpp
+/**
+* Opens a dialog to show the differences between two texts and lets the user edit the result
+*
+* @param title {QString} title of the dialog
+* @param label {QString} label text of the dialog
+* @param text1 {QString} first text
+* @param text2 {QString} second text
+* @return
+  */
+  QString ScriptingService::textDiffDialog(const QString &title, const QString &label,
+                                           const QString &text1, const QString &text2);
+```
+
+`text2` is the text you will be able to edit in the dialog.
+An empty string will be returned, if `Cancel` was clicked or `Escape` was pressed.
+
+### Example
+```js
+const text = script.noteTextEditSelectedText();
+const aiPrompt = "Translate the text to English";
+const aiResult = script.aiComplete(aiPrompt + ":\n\n" + text);
+
+var result = script.textDiffDialog("AI Text Tool", "Resulting text", text, aiResult);
+script.log(result);
+```
+
 Checking if a file exists
 -------------------------