[docs] fontTools.misc.* part 1 (#1956)

* Document misc.arrayTools * Document misc.bezierTools * Document cliTools * Document eexec
fonttools · May 19, 2020 · 76902b7 · 76902b7
1 parent db26cf8
commit 76902b7
Show file tree

Hide file tree

Showing 9 changed files with 514 additions and 144 deletions.
diff --git a/Doc/source/misc/arrayTools.rst b/Doc/source/misc/arrayTools.rst
@@ -1,8 +1,9 @@
-##########
-arrayTools
-##########
+#############################################
+arrayTools: Various array and rectangle tools
+#############################################
 
 .. automodule:: fontTools.misc.arrayTools
+   :member-order: bysource
    :inherited-members:
    :members:
    :undoc-members:
diff --git a/Doc/source/misc/bezierTools.rst b/Doc/source/misc/bezierTools.rst
@@ -1,6 +1,6 @@
-###########
-bezierTools
-###########
+####################################################
+bezierTools: Routines for working with Bezier curves
+####################################################
 
 .. automodule:: fontTools.misc.bezierTools
    :inherited-members:

diff --git a/Doc/source/misc/cliTools.rst b/Doc/source/misc/cliTools.rst
@@ -1,6 +1,6 @@
-########
-cliTools
-########
+###################################################################
+cliTools: Utilities for command-line interfaces and console scripts
+###################################################################
 
 .. automodule:: fontTools.misc.cliTools
    :inherited-members:

diff --git a/Doc/source/misc/eexec.rst b/Doc/source/misc/eexec.rst
@@ -1,6 +1,6 @@
-#####
-eexec
-#####
+###############################################################
+eexec: PostScript charstring encryption and decryption routines
+###############################################################
 
 .. automodule:: fontTools.misc.eexec
    :inherited-members:

diff --git a/Doc/source/misc/index.rst b/Doc/source/misc/index.rst
@@ -1,6 +1,9 @@
-####
-misc
-####
+##########################################################
+misc: Miscellaneous libraries helpful for font engineering
+##########################################################
+
+This is a collection of packages, most of which are used as internal support
+utilities by fontTools, but some of which may be more generally useful.
 
 .. toctree::
    :maxdepth: 2