Some doc improvements. Still a bit opaque why docs for certain things aren't showing up in Sphinx.

MaddieM4 · MaddieM4 · commit 816cdb16452d · 2026-03-12T17:41:57.000-06:00
diff --git a/doc/release/next_whats_new/dvi_parsing.rst b/doc/release/next_whats_new/dvi_parsing.rst
@@ -3,7 +3,7 @@ DVI Parsing enhancements
 
 Matplotlib is capable of reading ``.dvi`` files with `.dviread.Dvi`, which has historically worked well for its existing use cases, but did not provide the granularity to inspect the raw DVI operations in a file, and didn't have a way to report color information upwards to the various backends that might care about color directives.
 
-The new `.dviread.Ops` namespace provides the ability to inspect a DVI file one op at a time, `.dviread.VM` handles state tracking (and can be driven manually with its ``.op_foo(code, **args)`` methods, and the `.dviread.Text` and `.dviread.Box` classes have been modified to store color information in a backwards-compatible way.
+The new `.dviread.Ops` namespace provides the ability to inspect a DVI file one op at a time, `.dviread.VM` handles state tracking (and can be driven manually with its ``.op_foo(code, **args)`` methods, and the ``.dviread.Text`` and ``.dviread.Box`` classes have been modified to store color information in a backwards-compatible way.
 
 While backends don't render color directives yet, this important groundwork lets them *see* color directives, so that they can be acted on in the future.
 
diff --git a/lib/matplotlib/dviread.py b/lib/matplotlib/dviread.py
@@ -98,6 +98,7 @@ class DispatchTable:
         probably be a niche requirement in practice.
         """
         entries: list = dataclasses.field(
+            repr=False,
             default_factory=lambda: [('unknown', 0, ['delta'], ['delta'], None)] * 256)
 
         def op(self,
@@ -167,6 +168,7 @@ def op(self,
             ...        'u4      @length',
             ...        'length  payload')
             """
+
             arg_types = (' ' + arg_types).split()
             arg_names = (' ' + arg_names).split()
             entry = (opname, bmin, arg_types, arg_names, extra)
@@ -414,6 +416,10 @@ def _extra(f, l: int) -> dict:
 # for backwards compatibility, but is a dataclass.
 @dataclasses.dataclass(slots=True, frozen=True)
 class Box:
+    """
+    A rectangle defined within the dvi file.
+    """
+
     x: int
     y: int
     height: int
@@ -453,6 +459,7 @@ class Text:
     interpretation depends on the font).  ``text.width`` is the glyph width in
     dvi units.
     """
+
     x: int
     y: int
     font: 'DviFont'
@@ -1109,8 +1116,6 @@ class Vf:
     -----
     The virtual font format is a derivative of dvi:
     http://mirrors.ctan.org/info/knuth/virtual-fonts
-    This class reuses some of the machinery of `Dvi`
-    but replaces the `!_read` loop and dispatch mechanism.
 
     The format is:
      - `pre` op (247)
