You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/render/format_code_cells.md
+4-3Lines changed: 4 additions & 3 deletions
Original file line number
Diff line number
Diff line change
@@ -84,17 +84,18 @@ This can be set to:
84
84
(render/output/group-stderr-stdout)=
85
85
### Group into single streams
86
86
87
-
Cells may print multiple things to `stdout` and`stderr`.
87
+
Cells may print multiple things to `stdout`(and/or to `stderr`).
88
88
For example, if a cell prints status updates throughout its execution, each of these is often printed to `stdout`.
89
89
By default, these outputs may be split across multiple items, and will be rendered as separate "chunks" in your built documentation.
90
90
91
-
If you'd like each of the outputs in `stderr` and `stdout` to be merged into a single stream for each, use the following configuration:
91
+
If you'd like each of the outputs in `stdout` to be merged into a single stream for each, use the following configuration (see {ref}`config/intro`):
92
92
93
93
```python
94
94
nb_merge_streams =True
95
95
```
96
96
97
-
This will ensure that all `stderr` and `stdout` outputs are merged into a single group.
97
+
This will ensure that all `stdout` outputs are merged into a single group; likewise, all
98
+
`stderr` outputs will be merged into single (separate) group.
98
99
This also makes cell outputs more deterministic.
99
100
Normally, slight differences in timing may result in different orders of `stderr` and `stdout` in the cell output, while this setting will sort them properly.
0 commit comments