fix __init__ docstring order/markup
"""
Utility methods usable in various circumstances.
-* ``coordinates_of_segment``, ``coordinates_for_segment``, ``rotate_coordinates``, ``xywh_from_points``, ``points_from_xywh``, ``polygon_from_points``
+* ``coordinates_of_segment``, ``coordinates_for_segment``, ``rotate_coordinates``
These functions convert polygon outlines for PAGE elements on all hierarchy
levels (page, region, line, word, glyph) between relative coordinates w.r.t.
@@ -11,22 +11,27 @@ This includes rotation and offset correction.
* ``polygon_mask``, ``image_from_polygon``, ``crop_image``
These functions combine PIL.Image with polygons or bboxes.
-The functions have the syntax ``X_from_Y``, where ``X``/``Y`` can be
+
+* ``xywh_from_points``, ``points_from_xywh``, ``polygon_from_points`` etc.
+
+ These functions have the syntax ``X_from_Y``, where ``X``/``Y`` can be
* ``bbox`` is a 4-tuple of integers x0, y0, x1, y1 of the bounding box (rectangle)
+
+ (used by PIL.Image)
* ``points`` a string encoding a polygon: ``"0,0 100,0 100,100, 0,100"``
- * ``polygon`` is a list of 2-lists of integers x, y of points forming an (implicitly closed) polygon path: ``[[0,0], [100,0], [100,100], [0,100]]``
- * ``xywh`` a dict with keys for x, y, width and height: ``{'x': 0, 'y': 0, 'w': 100, 'h': 100}``
- * ``x0y0x1y1`` is a 4-list of strings ``x0``, ``y0``, ``x1``, ``y1`` of the bounding box (rectangle)
- * ``y0x0y1x1`` is the same as ``x0y0x1y1`` with positions of ``x`` and ``y`` in the list swapped
-``polygon`` is what opencv2 and higher-level coordinate functions in ocrd_utils expect
+ (used by PAGE-XML)
+ * ``polygon`` is a list of 2-lists of integers x, y of points forming an (implicitly closed) polygon path: ``[[0,0], [100,0], [100,100], [0,100]]``
-``xywh`` and ``x0y0x1y1`` are what tesserocr expects/produces.
+ (used by opencv2 and higher-level coordinate functions in ocrd_utils)
+ * ``xywh`` a dict with keys for x, y, width and height: ``{'x': 0, 'y': 0, 'w': 100, 'h': 100}``
-``points`` is what PAGE-XML uses.
+ (produced by tesserocr and image/coordinate recursion methods in ocrd.workspace)
+ * ``x0y0x1y1`` is a 4-list of strings ``x0``, ``y0``, ``x1``, ``y1`` of the bounding box (rectangle)
-``bbox`` is what PIL.Image uses.
+ (produced by tesserocr)
+ * ``y0x0y1x1`` is the same as ``x0y0x1y1`` with positions of ``x`` and ``y`` in the list swapped
* ``is_local_filename``, ``safe_filename``, ``abspath``
