Document NewTypes and ReaddirToken

Sphinx autoclass is currently confused by NewTypes, so document those by
hand.

Also, Sphinx wants to document the NewTypes as coming from
pyfuse3._pyfuse3, and there doesn't seem to be a setting or rST directive
to convince it otherwise.  Work around this by mangling the types'
__module__ attributes from conf.py.

rst/conf.py

@@ -104,6 +104,14 @@
 # A list of ignored prefixes for module index sorting.
 #modindex_common_prefix = []
 
+def setup(app):
+    # Mangle NewTypes re-exported from pyfuse3._pyfuse3 so they appear to
+    # come from their canonical location at the top of the package
+    import pyfuse3
+    for name in ('FileHandleT', 'FileNameT', 'FlagT', 'InodeT', 'ModeT',
+                 'XAttrNameT'):
+        getattr(pyfuse3, name).__module__ = 'pyfuse3'
+
 
 # -- Options for HTML output ---------------------------------------------------
 

rst/data.rst

@@ -43,6 +43,37 @@
 
 .. autoexception:: FUSEError
 
+.. autoclass currently doesn't work for NewTypes
+.. https://github.com/sphinx-doc/sphinx/issues/11552
+
+.. class:: FileHandleT
+
+   A subclass of `int`, representing an integer file handle produced by a
+   `~Operations.create`, `~Operations.open`, or `~Operations.opendir` call.
+
+.. class:: FileNameT
+
+   A subclass of `bytes`, representing a file name, with no embedded
+   zero-bytes (``\0``).
+
+.. class:: FlagT
+
+   A subclass of `int`, representing flags modifying the behavior of an
+   operation.
+
+.. class:: InodeT
+
+   A subclass of `int`, representing an inode number.
+
+.. class:: ModeT
+
+   A subclass of `int`, representing a file mode.
+
+.. class:: XAttrNameT
+
+   A subclass of `bytes`, representing an extended attribute name, with no
+   embedded zero-bytes (``\0``).
+
 .. autoclass:: RequestContext
 
    .. attribute:: pid
@@ -163,3 +194,7 @@
       If this attribute is true, it signals the `Operations.setattr`
       method that the `~EntryAttributes.st_size` field contains an
       updated value.
+
+.. autoclass:: ReaddirToken
+
+   An identifier for a particular `~Operations.readdir` invocation.