Define RST308

Author: peterjc

README.rst

@@ -125,6 +125,7 @@ RST304 Unknown interpreted text role "XXX".
 RST305 Undefined substitution referenced: "XXX".
 RST306 Unknown target name: "XXX".
 RST307 Error in "XXX" directive:
+RST308 Duplicate target name, cannot be used as a unique reference: "XXX".
 RST399 Previously unseen major error, not yet assigned a unique code.
 ====== =======================================================================
 
@@ -246,7 +247,9 @@ Version History
 ======= ========== ===========================================================
 Version Released   Changes
 ------- ---------- -----------------------------------------------------------
-v0.4.0  *Pending*  - Requires Python 3.9 or later.
+v0.4.0  *Pending*  - Tested with docutils v0.22.2
+                   - Adds `RST308` for duplicated target names.
+                   - Requires Python 3.9 or later.
 v0.3.1  2025-04-29 - Adds ``RST220`` for redefined anonymous links.
                    - Requires Python 3.8 or later (no code changes).
 v0.3.0  2022-11-16 - Replaced ``setup.py`` with ``pyproject.toml``.

flake8_rst_docstrings.py

@@ -80,6 +80,8 @@
     'Unknown target name: "*".': 6,
     # e.g. Error in "code" directive:
     'Error in "*" directive:': 7,
+    # e.g. Duplicate target name, cannot be used as a unique reference: "python".
+    'Duplicate target name, cannot be used as a unique reference: "*".': 8,
 }
 
 # Level 4 - severe

tests/RST220/dup_explicit_target.py

@@ -6,7 +6,7 @@
 What happens here?
 
     $ flake8 --select RST RST220/dup_explicit_target.py
-    RST220/dup_explicit_target.py:3:1: RST399 Duplicate target name, cannot be used as a unique reference: "python".
+    RST220/dup_explicit_target.py:3:1: RST308 Duplicate target name, cannot be used as a unique reference: "python".
     RST220/dup_explicit_target.py:15:1: RST220 Duplicate explicit target name: "python".
 
 This file triggers an error as there are repeated conflicting definitions: