RST217 Mismatch: both interpreted text role suffix and reference suffix.

Author: peterjc

README.rst

@@ -104,6 +104,7 @@ RST213 Inline emphasis start-string without end-string.
 RST214 Inline literal start-string without end-string.
 RST215 Inline interpreted text or phrase reference start-string without end-string.
 RST216 Multiple roles in interpreted text (both prefix and suffix present; only one allowed).
+RST217 Mismatch: both interpreted text role suffix and reference suffix.
 RST299 Previously unseen warning, not yet assigned a unique code.
 ====== =======================================================================
 
@@ -217,7 +218,7 @@ Version History
 ======= ========== ===========================================================
 Version Released   Changes
 ------- ---------- -----------------------------------------------------------
-v0.0.12 2019-11-18 - Adds ``RST213``, ``RST214``, ``RST215`` and ``RST216``.
+v0.0.12 2019-11-18 - Adds ``RST213`` to ``RST217``.
 v0.0.11 2019-08-07 - Configuration options to define additional directives and
                      roles (e.g. from Sphinx) for ``RST303`` and ``RST304``.
 v0.0.10 2019-06-17 - Fixed flake8 "builtins" parameter warning (contribution

flake8_rst_docstrings.py

@@ -175,6 +175,7 @@ def tokenize_open(filename):
     "Inline literal start-string without end-string.": 14,
     "Inline interpreted text or phrase reference start-string without end-string.": 15,
     "Multiple roles in interpreted text (both prefix and suffix present; only one allowed).": 16,
+    "Mismatch: both interpreted text role suffix and reference suffix.": 17,
 }
 
 # Level 3 - error

tests/RST217/roles.py

@@ -0,0 +1,17 @@
+"""Print 'Hello world' to the terminal.
+
+RST uses single backticks or back-quotes for various things including
+interpreted text roles and references.
+
+Without a semi-colon prefix or suffix, `example` has the default role.
+A prefix like :code:`example` or a suffix like `example`:math: is allowed.
+
+However, trailing underscores have special meaning for referencing, thus
+`code`:example:_ is considered to be an error:
+
+    $ flake8 --select RST RST217/roles.py
+    RST217/roles.py:10:1: RST17 Mismatch: both interpreted text role suffix and reference suffix.
+
+"""
+
+print("Hello world")