From 5a715330fc04c02a05228ce7bf2addc504fa5b7e Mon Sep 17 00:00:00 2001
From: Leena Miettinen <riitta-leena.miettinen@qt.io>
Date: Tue, 10 Oct 2023 11:15:59 +0200
Subject: [PATCH] Doc: Describe detaching views

Fixes: QTCREATORBUG-29636
Change-Id: I980d7c523bd40cbc7ad56696987688839baf154d
Reviewed-by: David Schulz <david.schulz@qt.io>
---
 doc/qtcreator/images/icons/detach-view.png    | Bin 0 -> 191 bytes
 .../images/qtcreator-attach-views.webp        | Bin 0 -> 4234 bytes
 .../src/analyze/creator-valgrind.qdoc         |   1 +
 .../creator-coding-edit-mode.qdoc             |   2 +
 .../howto/creator-only/creator-how-tos.qdoc   |   1 +
 doc/qtcreator/src/qtcreator-toc.qdoc          |   1 +
 .../creator-how-to-detach-views.qdoc          |  41 ++++++++++++++++++
 7 files changed, 46 insertions(+)
 create mode 100644 doc/qtcreator/images/icons/detach-view.png
 create mode 100644 doc/qtcreator/images/qtcreator-attach-views.webp
 create mode 100644 doc/qtcreator/src/user-interface/creator-only/creator-how-to-detach-views.qdoc

diff --git a/doc/qtcreator/images/icons/detach-view.png b/doc/qtcreator/images/icons/detach-view.png
new file mode 100644
index 0000000000000000000000000000000000000000..1cc3d8df400060bf1aeffc7ad519b7f65339603f
GIT binary patch
literal 191
zcmeAS@N?(olHy`uVBq!ia0y~yU=RRd4i*LmhONKMUokK+w0XKXhG?8mPEcTw5Iobi
zo+szUCEhhYEj|h>8dy93wmNns$_m}@bYxhyAW@!~pP89inwhy-DdwXQn{*4OS;28B
zr<ebEPIr_rPwe}1^1y+B4i&53#)*km%k%{v=rb!Hj;`VQXJBCBF<BzOhv%J!-~aY?
s4ZVsCu8;XcSj8nOF8ciANoHX9aZE(ed_&6_1_lNOPgg&ebxsLQ0I}sim;e9(

literal 0
HcmV?d00001

diff --git a/doc/qtcreator/images/qtcreator-attach-views.webp b/doc/qtcreator/images/qtcreator-attach-views.webp
new file mode 100644
index 0000000000000000000000000000000000000000..9d9785088505186d2c4ceb0e54d8620fa0e0a025
GIT binary patch
literal 4234
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
Z_@n=Lz0JSJALaZ1SD*-eK4aU(000lc0W|;s

literal 0
HcmV?d00001

diff --git a/doc/qtcreator/src/analyze/creator-valgrind.qdoc b/doc/qtcreator/src/analyze/creator-valgrind.qdoc
index f905cb1766a..9ccfa45c409 100644
--- a/doc/qtcreator/src/analyze/creator-valgrind.qdoc
+++ b/doc/qtcreator/src/analyze/creator-valgrind.qdoc
@@ -324,6 +324,7 @@
 
     \endlist
 
+    \sa {Detach views}
 */
 
 /*!
diff --git a/doc/qtcreator/src/editors/creator-only/creator-coding-edit-mode.qdoc b/doc/qtcreator/src/editors/creator-only/creator-coding-edit-mode.qdoc
index 6602548e7b1..dc2d905cadc 100644
--- a/doc/qtcreator/src/editors/creator-only/creator-coding-edit-mode.qdoc
+++ b/doc/qtcreator/src/editors/creator-only/creator-coding-edit-mode.qdoc
@@ -338,4 +338,6 @@
     \QC underlines semantic errors in olive in the C++ code editor. To check the
     correct paths for includes that are not resolved or that are resolved to the
     wrong file, select \uicontrol {Project Parts} > \uicontrol {Header Paths}.
+
+    \sa {Detach views}
 */
diff --git a/doc/qtcreator/src/howto/creator-only/creator-how-tos.qdoc b/doc/qtcreator/src/howto/creator-only/creator-how-tos.qdoc
index 55151151a79..94a4f288393 100644
--- a/doc/qtcreator/src/howto/creator-only/creator-how-tos.qdoc
+++ b/doc/qtcreator/src/howto/creator-only/creator-how-tos.qdoc
@@ -124,6 +124,7 @@
 
     \list
         \li \l {Assign keyboard shortcuts}
+        \li \l {Detach views}
         \li \l {Find a particular preference}
         \li \l {Find keyboard shortcuts}
         \li \l {Find menu items on \macos}
diff --git a/doc/qtcreator/src/qtcreator-toc.qdoc b/doc/qtcreator/src/qtcreator-toc.qdoc
index 6a5d621ed53..5fcbee47a94 100644
--- a/doc/qtcreator/src/qtcreator-toc.qdoc
+++ b/doc/qtcreator/src/qtcreator-toc.qdoc
@@ -262,6 +262,7 @@
             \li Use the UI
                 \list
                     \li \l {Assign keyboard shortcuts}
+                    \li \l {Detach views}
                     \li \l {Find a particular preference}
                     \li \l {Find keyboard shortcuts}
                     \li \l {Find menu items on \macos}
diff --git a/doc/qtcreator/src/user-interface/creator-only/creator-how-to-detach-views.qdoc b/doc/qtcreator/src/user-interface/creator-only/creator-how-to-detach-views.qdoc
new file mode 100644
index 00000000000..3534e055ec8
--- /dev/null
+++ b/doc/qtcreator/src/user-interface/creator-only/creator-how-to-detach-views.qdoc
@@ -0,0 +1,41 @@
+// Copyright (C) 2023 The Qt Company Ltd.
+// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
+
+/*!
+    \page creator-how-to-detach-views.html
+    \previouspage creator-how-tos.html
+
+    \ingroup creator-how-to-ui
+
+    \title Detach views
+
+    You can detach \QC views that have the \inlineimage icons/detach-view.png
+    icon. You can then move them to other places on the screen or to other
+    screens.
+
+    To detach views:
+
+    \list
+        \li Double-click the title bar of the view.
+        \li Grab the title bar of the view with the mouse and start moving the
+            view to another position on the screen.
+        \li Select \inlineimage icons/detach-view.png
+            .
+    \endlist
+
+    To show the title bars of views, select \uicontrol View > \uicontrol Views,
+    and deselect the \uicontrol {Automatically Hide Title Bars} check box.
+
+    \section1 Attach views
+
+    To attach views, drag them to a highlighted dock area.
+
+    \image qtcreator-attach-views.webp {Attaching a view to a dock area}
+
+    \section1 Revert changes
+
+    To open closed views, select \uicontrol View > \uicontrol Views.
+
+    To revert the changes, select \uicontrol View > \uicontrol Views >
+    \uicontrol {Reset to Default Layout}.
+*/