Allow Python and JavaScript reference paths to span multiple lines.
Review Request #9987 — Created May 30, 2018 and submitted — Latest diff uploaded
This introduces a new Sphinx extension,
ref_utils
, which augments the
various Python and JavaScript reference roles (like:py:class:
) to
allow references to span multiple lines. For instance,
foo.bar.\nMyClass
. This is useful when working with very long paths
that would otherwise greatly extend a line.
Used this in some documentation to break up otherwise very long lines.
Made sure this didn't introduce any build errors or broken links.