wrapping for Python rst paragraphs with inline directives mistakes the inline for a block directive
zzzeek opened this issue · comments
Michael Bayer commented
when restructured text includes inline colon directives like :ref:
or sphinx-specific elements like :meth:
, :class:
, etc. , wrap plus thinks these are beginning an indented section:
# works:
The change includes that we have modified
the
thing :meth:`_schema.Table.tometadata` to now
read as :meth:`_schema.Table.to_metadata`.
# result:
The change includes that we have modified the thing
:meth:`_schema.Table.tometadata` to now read as
:meth:`_schema.Table.to_metadata`.
# doesn't work:
The change includes that we have modified
the thing
:meth:`_schema.Table.tometadata` to now
read as :meth:`_schema.Table.to_metadata`.
# result:
The change includes that we have modified the thing
:meth:`_schema.Table.tometadata` to now read as
:meth:`_schema.Table.to_metadata`.