Move the "Unmatched exceptions" section up, as @iritkatriel suggested

1st1 · 1st1 · commit dea774191b55 · 2020-10-27T09:02:25.000-07:00
diff --git a/except_star.md b/except_star.md
@@ -106,59 +106,6 @@ InterruptedError
 BlockingIOError
 ```
 
-### Raising ExceptionGroups manually
-
-Exception groups can be raised manually:
-
-```python
-try:
-  low_level_os_operation()
-except *OSerror as errors:
-  new_errors = []
-  for e in errors:
-    if e.errno != errno.EPIPE:
-       new_errors.append(e)
-  raise ExceptionGroup(*new_errors)
-```
-
-The above code ignores all `EPIPE` OS errors, while letting all other
-exceptions propagate.
-
-Raising an `ExceptionGroup` introduces nesting:
-
-```python
-try:
-  raise ExceptionGroup(ValueError('a'), TypeError('b'))
-except *ValueError:
-  raise ExceptionGroup(KeyError('x'), KeyError('y'))
-
-# would result in:
-#
-#   ExceptionGroup(
-#     ExceptionGroup(
-#       KeyError('x'),
-#       KeyError('y'),
-#     ),
-#     TypeError('b'),
-#   )
-```
-
-Although a regular `raise Exception` would not wrap `Exception` in a group:
-
-```python
-try:
-  raise ExceptionGroup(ValueError('a'), TypeError('b'))
-except *ValueError:
-  raise KeyError('x')
-
-# would result in:
-#
-#   ExceptionGroup(
-#     KeyError('x'),
-#     TypeError('b')
-#   )
-```
-
 ### Unmatched Exceptions
 
 Example:
@@ -186,11 +133,9 @@ and then terminate with an unhandled `ExceptionGroup`:
 
 ```
 ExceptionGroup(
+  TypeError('b'),
+  TypeError('c'),
   KeyError('e'),
-  ExceptionGroup(
-    TypeError('b'),
-    TypeError('c')
-  )
 )
 ```
 
@@ -241,6 +186,59 @@ except *BlockingIOError:
 #   ExceptionGroup(BlockingIOError())
 ```
 
+### Raising ExceptionGroups manually
+
+Exception groups can be raised manually:
+
+```python
+try:
+  low_level_os_operation()
+except *OSerror as errors:
+  new_errors = []
+  for e in errors:
+    if e.errno != errno.EPIPE:
+       new_errors.append(e)
+  raise ExceptionGroup(*new_errors)
+```
+
+The above code ignores all `EPIPE` OS errors, while letting all other
+exceptions propagate.
+
+Raising an `ExceptionGroup` introduces nesting:
+
+```python
+try:
+  raise ExceptionGroup(ValueError('a'), TypeError('b'))
+except *ValueError:
+  raise ExceptionGroup(KeyError('x'), KeyError('y'))
+
+# would result in:
+#
+#   ExceptionGroup(
+#     ExceptionGroup(
+#       KeyError('x'),
+#       KeyError('y'),
+#     ),
+#     TypeError('b'),
+#   )
+```
+
+Although a regular `raise Exception` would not wrap `Exception` in a group:
+
+```python
+try:
+  raise ExceptionGroup(ValueError('a'), TypeError('b'))
+except *ValueError:
+  raise KeyError('x')
+
+# would result in:
+#
+#   ExceptionGroup(
+#     KeyError('x'),
+#     TypeError('b')
+#   )
+```
+
 ### Exception Chaining
 
 If an error occurs during processing a set of exceptions in a `except *` block,
