Docs, minor: add regularized title text to all modules.

Doc/source/afmLib.rst

@@ -1,6 +1,6 @@
-###########################################
-afmLib: Read/write Adobe Font Metrics files
-###########################################
+###############################################
+afmLib: Read and write Adobe Font Metrics files
+###############################################
 
 .. automodule:: fontTools.afmLib
 

Doc/source/cffLib/CFF2ToCFF.rst

@@ -0,0 +1,7 @@
+##############################
+CFF2ToCFF: convert CFF2 to CFF
+##############################
+
+.. automodule:: fontTools.cffLib.CFF2ToCFF
+   :inherited-members:
+   :members:

Doc/source/cffLib/CFFToCFF2.rst

@@ -0,0 +1,7 @@
+##############################
+CFFToCFF2: convert CFF to CFF2
+##############################
+
+.. automodule:: fontTools.cffLib.CFFToCFF2
+   :inherited-members:
+   :members:

Doc/source/cffLib/index.rst

@@ -1,13 +1,22 @@
-##################################
-cffLib: read/write Adobe CFF fonts
-##################################
+######################################
+cffLib: Read and write Adobe CFF fonts
+######################################
 
-.. automodule:: fontTools.cffLib
+This package contains modules for converting between CCF and CFF2:
 
-This package also contains two modules for manipulating CFF format glyphs:
+.. toctree::
+   :maxdepth: 1
+
+   CFFToCFF2
+   CFF2ToCFF
+
+and modules for manipulating CFF format glyphs:
 
 .. toctree::
    :maxdepth: 1
 
    specializer
    width
+
+.. automodule:: fontTools.cffLib
+

Doc/source/config.rst

@@ -1,5 +1,5 @@
 ###########################
-config: configure fontTools
+config: Configure fontTools
 ###########################
 
 .. automodule:: fontTools.config

Doc/source/cu2qu/index.rst

@@ -1,6 +1,6 @@
-##########################################
-cu2qu: Cubic to quadratic curve conversion
-##########################################
+########################################
+cu2qu: Convert cubic curves to quadratic
+########################################
 
 Routines for converting cubic curves to quadratic splines, suitable for use
 in OpenType to TrueType outline conversion.

Doc/source/designspaceLib/index.rst

@@ -4,7 +4,7 @@ designspaceLib: Read, write, and edit designspace files
 
 Implements support for reading and manipulating ``designspace`` files.
 Allows the users to define axes, rules, sources, variable fonts and instances,
-and their STAT information.
+and their ``STAT`` information.
 
 .. toctree::
    :maxdepth: 1

Doc/source/encodings/index.rst

@@ -1,6 +1,6 @@
-##################################################
-encodings: Support for OpenType-specific encodings
-##################################################
+############################################################
+encodings: Support for OpenType-specific character encodings
+############################################################
 
 fontTools includes support for some character encodings found in legacy Mac
 TrueType fonts. Many of these legacy encodings have found their way into the

Doc/source/feaLib/index.rst

@@ -1,6 +1,6 @@
-#########################################
-feaLib: Read/write OpenType feature files
-#########################################
+#############################################
+feaLib: Read and write OpenType feature files
+#############################################
 
 fontTools' ``feaLib`` allows for the creation and parsing of Adobe
 Font Development Kit for OpenType feature (``.fea``) files. The syntax

Doc/source/pens/index.rst

@@ -1,6 +1,6 @@
-####
-pens
-####
+###########################################
+pens: Inspect and manipulate glyph outlines
+###########################################
 
 .. toctree::
    :maxdepth: 1

Doc/source/subset/index.rst

@@ -1,6 +1,6 @@
-######
-subset
-######
+########################################################
+subset: Generate subsets of fonts or optimize file sizes
+########################################################
 
 .. toctree::
    :maxdepth: 1

Doc/source/svgLib/index.rst

@@ -1,6 +1,6 @@
-######
-svgLib
-######
+############################################
+svgLib: Read and write SVG-in-OpenType fonts
+############################################
 
 .. toctree::
    :maxdepth: 1

Doc/source/t1Lib.rst

@@ -1,6 +1,6 @@
-#####
-t1Lib
-#####
+#############################################
+t1Lib: Read and write PostScript Type 1 fonts
+#############################################
 
 .. automodule:: fontTools.t1Lib
    :inherited-members:

Doc/source/ttLib/index.rst

@@ -1,6 +1,6 @@
-#############################################
-ttLib: Read/write OpenType and TrueType fonts
-#############################################
+#################################################
+ttLib: Read and write OpenType and TrueType fonts
+#################################################
 
 Most users of the fontTools library will be using it to generate or manipulate
 OpenType and TrueType fonts. (FontTools initially only supported TrueType fonts,

Doc/source/ttx.rst

@@ -1,6 +1,6 @@
-###
-ttx
-###
+##################################
+ttx: Convert fonts to XML and back
+##################################
 
 
 TTX – From OpenType and TrueType to XML and Back

Doc/source/varLib/index.rst

@@ -1,7 +1,6 @@
-##################################
-varLib: OpenType Variation Support
-##################################
-
+#######################################
+varLib: Support for OpenType Variations
+#######################################
 
 .. toctree::
    :maxdepth: 2

Doc/source/voltLib/index.rst

@@ -1,6 +1,6 @@
-####################################
-voltLib: Read/write MS VOLT projects
-####################################
+########################################
+voltLib: Read and write MS VOLT projects
+########################################
 
 .. toctree::
    :maxdepth: 2