Docs: cffLib, minor updates.

Doc/source/cffLib/CFF2ToCFF.rst

@@ -5,3 +5,6 @@ CFF2ToCFF: convert CFF2 to CFF
 .. automodule:: fontTools.cffLib.CFF2ToCFF
    :inherited-members:
    :members:
+   :undoc-members:
+
+

Doc/source/cffLib/CFFToCFF2.rst

@@ -5,3 +5,4 @@ CFFToCFF2: convert CFF to CFF2
 .. automodule:: fontTools.cffLib.CFFToCFF2
    :inherited-members:
    :members:
+   :undoc-members:

Doc/source/cffLib/index.rst

@@ -2,21 +2,37 @@
 cffLib: Read and write Adobe CFF fonts
 ######################################
 
-This package contains modules for converting between CCF and CFF2:
+.. rubric:: Overview:
+   :heading-level: 3
 
-.. toctree::
-   :maxdepth: 1
-
-   CFFToCFF2
-   CFF2ToCFF
-
-and modules for manipulating CFF format glyphs:
-
-.. toctree::
-   :maxdepth: 1
-
-   specializer
-   width
 
 .. automodule:: fontTools.cffLib
+   :inherited-members:
+   :members: 
+   :undoc-members:
+   :member-order: bysource
+
+    .. rubric:: Submodules:
+       :heading-level: 3
+
+    cffLib contains submodules for converting between CCF and CFF2.
+    Each can be used within other Python code or run as a
+    command-line console script:
+
+     .. toctree::
+        :maxdepth: 1
+     
+        CFFToCFF2
+        CFF2ToCFF
+     
+    It also contains submodules for manipulating CFF-formatted glyphs:
+     
+     .. toctree::
+        :maxdepth: 1
+     
+        specializer
+        width
+    
+    .. rubric:: Module members:
+       :heading-level: 3
  

Doc/source/cffLib/specializer.rst

@@ -2,7 +2,15 @@
 specializer: T2CharString operator specializer and generalizer
 ##############################################################
 
+.. rubric:: Overview:
+   :heading-level: 3
+
 .. automodule:: fontTools.cffLib.specializer
    :inherited-members:
    :members:
    :undoc-members:
+
+
+    .. rubric:: Module members:
+       :heading-level: 3
+    		  

Lib/fontTools/cffLib/__init__.py

@@ -1,7 +1,7 @@
 """cffLib: read/write Adobe CFF fonts
 
-OpenType fonts with PostScript outlines contain a completely independent
-font file, Adobe's *Compact Font Format*. So dealing with OpenType fonts
+OpenType fonts with PostScript outlines embed a completely independent
+font file in Adobe's *Compact Font Format*. So dealing with OpenType fonts
 requires also dealing with CFF. This module allows you to read and write
 fonts written in the CFF format.