Improve summary lines in docs

Author: mdboom

doc/source/_templates/autosummary/class.rst

@@ -12,7 +12,7 @@
    .. rubric:: Methods
 
    .. autosummary::
-      :toctree: _generated
+      :toctree: .
    {% for item in methods %}
       ~{{ name }}.{{ item }}
    {%- endfor %}
@@ -24,7 +24,7 @@
    .. rubric:: Attributes
 
    .. autosummary::
-      :toctree: _generated
+      :toctree: .
    {% for item in attributes %}
       ~{{ name }}.{{ item }}
    {%- endfor %}

docstrings/bitmap.py

@@ -75,11 +75,13 @@
 """
 
 Bitmap_pitch = """
-The pitch's absolute value is the number of bytes taken by one bitmap
-row, including padding. However, the pitch is positive when the bitmap
-has a ‘down’ flow, and negative when it has an ‘up’ flow. In all
-cases, the pitch is an offset to add to a bitmap pointer in order to
-go down one row.
+The number of bytes taken by one bitmap row.
+
+Includes padding.
+
+The pitch is positive when the bitmap has a ‘down’ flow, and negative
+when it has an ‘up’ flow. In all cases, the pitch is an offset to add
+to a bitmap pointer in order to go down one row.
 
 Note that ‘padding’ means the alignment of a bitmap to a byte border,
 and FreeType functions normally align to the smallest possible integer

docstrings/charmap.py

@@ -67,7 +67,7 @@
 """
 
 CharMap_get_format = """
-Return TrueType/sfnt specific cmap format.
+Get the TrueType/sfnt specific cmap format.
 
 Returns
 -------
@@ -77,7 +77,7 @@
 """
 
 CharMap_get_language_id = """
-Return TrueType/sfnt specific cmap language ID.
+Get the TrueType/sfnt specific cmap language ID.
 
 It will be one of the constants in `TT_MAC_LANGID` or `TT_MS_LANGID`.