aboutsummaryrefslogtreecommitdiffstats
path: root/sources/pyside6/doc/tutorials/debugging
diff options
context:
space:
mode:
authorCristián Maureira-Fredes <Cristian.Maureira-Fredes@qt.io>2023-04-04 17:19:23 +0200
committerCristián Maureira-Fredes <Cristian.Maureira-Fredes@qt.io>2023-04-05 09:26:43 +0200
commit900c050c66119454585ec83cf31149f6d64dd3ea (patch)
treec9db45471d33aaf9ca6ad7de191d73eed2cbec24 /sources/pyside6/doc/tutorials/debugging
parentd35b650fe4369952a44c3891fedb6d8ee1417df5 (diff)
doc: fix issues with pyside rst files
Fixing extra indentation, syntax issues, and formatting. Adapting too some snippet line highlights, and many other details. Pick-to: 6.5 Change-Id: Ife4eb5cec03577b2902d409b4007ae6d12141747 Reviewed-by: Friedemann Kleint <Friedemann.Kleint@qt.io>
Diffstat (limited to 'sources/pyside6/doc/tutorials/debugging')
-rw-r--r--sources/pyside6/doc/tutorials/debugging/qtcreator/qtcreator.rst26
-rw-r--r--sources/pyside6/doc/tutorials/debugging/vscode/vscode.rst42
2 files changed, 34 insertions, 34 deletions
diff --git a/sources/pyside6/doc/tutorials/debugging/qtcreator/qtcreator.rst b/sources/pyside6/doc/tutorials/debugging/qtcreator/qtcreator.rst
index c8c9fb8ae..a35020fd1 100644
--- a/sources/pyside6/doc/tutorials/debugging/qtcreator/qtcreator.rst
+++ b/sources/pyside6/doc/tutorials/debugging/qtcreator/qtcreator.rst
@@ -14,26 +14,26 @@ Here are the steps:
2. Go to Projects -> Run -> Run Configuration -> Add. This is going to open a
new window shown below.
- .. image:: custom_executable_create.png
- :alt: creation of custom executable
- :align: center
+ .. image:: custom_executable_create.png
+ :alt: creation of custom executable
+ :align: center
3. Click on Custom Executable and `Create` a new configuration. Feed in the
-details like shown below.
+ details like shown below.
- .. image:: custom_executable_run_config.png
- :alt: run configuration of custom executable
- :align: center
+ .. image:: custom_executable_run_config.png
+ :alt: run configuration of custom executable
+ :align: center
4. Debug -> Start Debugging -> Start Debugging Without Deployment.
- .. image:: start_debugging_without_deployment.png
- :alt: start debugging without deployment
- :align: center
+ .. image:: start_debugging_without_deployment.png
+ :alt: start debugging without deployment
+ :align: center
You will now hit you breakpoint and can start debugging your code.
- .. image:: breakpoint_cpp.png
- :alt: breakpoint cpp
- :align: center
+.. image:: breakpoint_cpp.png
+ :alt: breakpoint cpp
+ :align: center
diff --git a/sources/pyside6/doc/tutorials/debugging/vscode/vscode.rst b/sources/pyside6/doc/tutorials/debugging/vscode/vscode.rst
index 806035299..b2a527b0e 100644
--- a/sources/pyside6/doc/tutorials/debugging/vscode/vscode.rst
+++ b/sources/pyside6/doc/tutorials/debugging/vscode/vscode.rst
@@ -36,7 +36,7 @@ search for "Python: Select Interpreter".
Creating Configurations in launch.json
--------------------------------------
-Run -> Add Configuration -> Python -> Python File
+``Run -> Add Configuration -> Python -> Python File``
This should create a launch.json file which looks like this:
@@ -145,7 +145,7 @@ Debug The Process
1. Set a breakpoint in the Python code.
-2. Go to `Run And Debug` (Ctrl + Shift + D) and run the "Python: Current File"
+2. Go to ``Run And Debug`` (Ctrl + Shift + D) and run the "Python: Current File"
by clicking the run symbol (green right-arrow). This will hit the breakpoint
and will halt the Python debugger.
@@ -153,40 +153,40 @@ Debug The Process
Current File" to "(gdb) Attach" or "(Windows) Attach". Your setup should now
look like this.
- .. image:: breakpoint_gdb.png
- :alt: breakpoint before attach gdb
- :align: center
+ .. image:: breakpoint_gdb.png
+ :alt: breakpoint before attach gdb
+ :align: center
4. Run "(gdb) Attach" or "(Windows) Attach" and this should ask you for the
processId of the Python process to which you want to attach the C++ debugger.
VSCode also lets you search for the process by its name.
- .. tip:: You can find the processId by running `ps aux | grep python`
+ .. tip:: You can find the processId by running ``ps aux | grep python``
- .. image:: find_process_gdb.png
- :alt: find process vscode
- :align: center
+ .. image:: find_process_gdb.png
+ :alt: find process vscode
+ :align: center
5. VSCode might now ask you for superuser permissions. In that case, type 'y'
and enter your password.
- .. code-block:: bash
+ .. code-block:: bash
- Superuser access is required to attach to a process. Attaching as
- superuser can potentially harm your computer. Do you want to continue?
- [y/N]_
+ Superuser access is required to attach to a process. Attaching as
+ superuser can potentially harm your computer. Do you want to continue?
+ [y/N]_
6. That is it. You should now be able to hit the breakpoints that you have set
on the C++ counterparts.
- .. figure:: audioformat_wrapper.png
- :alt: Breakpoint set on the shiboken wrapper class
- :align: left
+ .. figure:: audioformat_wrapper.png
+ :alt: Breakpoint set on the shiboken wrapper class
+ :align: left
- Breakpoint set on the shiboken wrapper class
+ Breakpoint set on the shiboken wrapper class
- .. figure:: audioformat_cpp.png
- :alt: Breakpoint set on C++ implementation
- :align: left
+ .. figure:: audioformat_cpp.png
+ :alt: Breakpoint set on C++ implementation
+ :align: left
- Breakpoint set on C++ implementation
+ Breakpoint set on C++ implementation