Fix docs.

Author: tobiasraabe

docs/source/_static/md/pdb.md

@@ -8,7 +8,7 @@ Platform: win32 -- Python 3.12.0, pytask 0.5.3, pluggy 1.3.0
 Root: C:\Users\pytask-dev\git\my_project
 Collected 1 task.
 
->>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> Traceback >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
+>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> Traceback >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
 <span style="color: #f14c4c">╭───────────────────</span><span style="color: #f14c4c; font-weight: bold;"> Traceback </span><span style="color: #6c1e1e; font-weight: bold">(most recent call last)</span><span style="color: #f14c4c"> ─────────────────╮</span>
 <span style="color: #f14c4c">│</span>                                                                       <span style="color: #f14c4c">│</span>
 <span style="color: #f14c4c">│</span> <span style="color: #e5e510">.../task_data_preparation.py</span>:<span style="color: var(--termynal-blue)">23</span> in <span style="color: #23d18b">task_create_random_data</span>            <span style="color: #f14c4c">│</span>
@@ -24,7 +24,7 @@ Collected 1 task.
 <span style="color: #f14c4c; font-weight: bold;">Exception</span>
 
 >>>>>>>>>>>>>>>> PDB post_mortem (IO-capturing turned off) >>>>>>>>>>>>>>
-> ...\git\my_project\task_data_preparation.py(23)task_create_random_data()
+> ...\my_project\task_data_preparation.py(23)task_create_random_data()
 -> raise Exception
 <span data-ty="input" data-ty-prompt="(Pdb)" data-ty-cursor="▋"></span>
 

docs/source/_static/md/show-locals.md

@@ -8,9 +8,9 @@ Platform: win32 -- Python 3.12.0, pytask 0.5.3, pluggy 1.3.0
 Root: C:\Users\pytask-dev\git\my_project
 Collected 1 task.
 
->>>>>>>>>>>>>>>> PDB runcall (IO-capturing turned off) >>>>>>>>>>>>>>>
+>>>>>>>>>>>>>>>>>> PDB runcall (IO-capturing turned off) >>>>>>>>>>>>>>>>
 
-> ...\git\my_project\task_create_random_data.py(13)task_create_random_data()
+> ...\my_project\task_create_random_data.py(13)task_create_random_data()
 -> rng = np.random.default_rng(0)
 <span data-ty="input" data-ty-prompt="(Pdb)" data-ty-cursor="▋"></span>
 

docs/source/_static/md/trace.md

@@ -87,13 +87,5 @@ and then run `pytask`.
 Or, you use a temporary environment variable. Here is an example for bash.
 
 ```console
-PYTHONWARNINGS=error pytask --pdb
-```
-
-and here for Powershell
-
-```console
-$env:PYTHONWARNINGS = 'error'
-pytask
-Remove-Item env:\PYTHONWARNINGS
+$ PYTHONWARNINGS=error pytask --pdb
 ```

docs/source/how_to_guides/capture_warnings.md

@@ -11,33 +11,19 @@ If an input is not parsed by any more specific node type, the general
 In the following example, the argument `text` will be parsed as a
 {class}`~pytask.PythonNode`.
 
-`````{tab-set}
-
-````{tab-item} Python 3.10+
-
 ```{literalinclude} ../../../docs_src/how_to_guides/hashing_inputs_of_tasks_example_1_py310.py
 ```
 
-````
-`````
-
 By default, pytask does not detect changes in {class}`~pytask.PythonNode` and if the
 value would change (without changing the task module), pytask would not rerun the task.
 
 We can also hash the value of {class}`~pytask.PythonNode` s so that pytask knows when
 the input changed. For that, we need to use the {class}`~pytask.PythonNode` explicitly
 and set `hash = True`.
 
-`````{tab-set}
-
-````{tab-item} Python 3.10+
-
 ```{literalinclude} ../../../docs_src/how_to_guides/hashing_inputs_of_tasks_example_2_py310.py
 ```
 
-````
-`````
-
 When `hash=True`, pytask will call the builtin {func}`hash` on the input that will call
 the `__hash__()` method of the object.
 
@@ -75,12 +61,5 @@ $ conda install deepdiff
 Then, create the hash function and pass it to the node. Make sure it returns either an
 integer or a string.
 
-`````{tab-set}
-
-````{tab-item} Python 3.10+
-
 ```{literalinclude} ../../../docs_src/how_to_guides/hashing_inputs_of_tasks_example_3_py310.py
 ```
-
-````
-`````

docs/source/how_to_guides/hashing_inputs_of_tasks.md

@@ -25,7 +25,7 @@ as the task module because it is a relative path.
 
 ```{literalinclude} ../../../docs_src/how_to_guides/provisional_products.py
 ---
-emphasize-lines: 4, 22
+emphasize-lines: 6, 23
 ---
 ```
 
@@ -57,7 +57,7 @@ downloaded.
 
 ```{literalinclude} ../../../docs_src/how_to_guides/provisional_task.py
 ---
-emphasize-lines: 9
+emphasize-lines: 4, 9
 ---
 ```
 
@@ -86,6 +86,9 @@ The code snippet shows each task takes one of the downloaded files and copies it
 content to a `.txt` file.
 
 ```{literalinclude} ../../../docs_src/how_to_guides/provisional_task_generator.py
+---
+emphasize-lines: 4, 11
+---
 ```
 
 ```{important}

docs/source/how_to_guides/provisional_nodes_and_task_generators.md

@@ -70,13 +70,12 @@ This command only runs the first two tasks.
 $ pytask -k "1 or 2 and not 12"
 ```
 
-To execute a single task, say `task_run_this_one` in `task_example.py`, use
+To execute a single task, say `task_run_this_one` in `task_example.py`, use one of the
+following commands.
 
 ```console
 $ pytask -k task_example.py::task_run_this_one
 
-# or
-
 $ pytask -k task_run_this_one
 ```