From ed4ae0a26c04dec85b29e6c7d551ad599bc06187 Mon Sep 17 00:00:00 2001
From: Axel Kohlmeyer <akohlmey@gmail.com>
Date: Thu, 26 Oct 2023 04:44:05 -0400
Subject: [PATCH] find more misformatted references in ReST sources

---
 doc/Makefile                | 4 ++++
 doc/src/fix_srd.rst         | 4 ++--
 doc/src/improper_amoeba.rst | 4 ++--
 3 files changed, 8 insertions(+), 4 deletions(-)

diff --git a/doc/Makefile b/doc/Makefile
index 2a4edc70f3..b652c515e1 100644
--- a/doc/Makefile
+++ b/doc/Makefile
@@ -63,6 +63,7 @@ help:
 	@echo "  anchor_check  scan for duplicate anchor labels"
 	@echo "  style_check   check for complete and consistent style lists"
 	@echo "  package_check check for complete and consistent package lists"
+	@echo "  role_check    check for misformatted role keywords"
 	@echo "  spelling      spell-check the manual"
 
 # ------------------------------------------
@@ -98,6 +99,7 @@ html: xmlgen $(VENV) $(SPHINXCONFIG)/conf.py $(ANCHORCHECK) $(MATHJAX)
 		env LC_ALL=C grep -n '[^ -~]' $(RSTDIR)/*.rst ;\
 		env LC_ALL=C grep -n ' :[a-z]\+`' $(RSTDIR)/*.rst ;\
 		env LC_ALL=C grep -n ' `[^`]\+<[a-z][^`]\+`[^_]' $(RSTDIR)/*.rst ;\
+		env LC_ALL=C grep -n ':\(ref\|doc\):[^`]' $(RSTDIR)/*.rst ;\
 		$(PYTHON) $(BUILDDIR)/utils/check-styles.py -s ../src -d src ;\
 		echo "############################################" ;\
 		deactivate ;\
@@ -179,6 +181,7 @@ pdf: xmlgen $(VENV) $(SPHINXCONFIG)/conf.py $(ANCHORCHECK)
 		env LC_ALL=C grep -n '[^ -~]' $(RSTDIR)/*.rst ;\
 		env LC_ALL=C grep -n ' :[a-z]\+`' $(RSTDIR)/*.rst ;\
 		env LC_ALL=C grep -n ' `[^`]\+<[a-z][^`]\+`[^_]' $(RSTDIR)/*.rst ;\
+		env LC_ALL=C grep -n ':\(ref\|doc\):[^`]' $(RSTDIR)/*.rst ;\
 		$(PYTHON) utils/check-styles.py -s ../src -d src ;\
 		echo "############################################" ;\
 		deactivate ;\
@@ -227,6 +230,7 @@ char_check :
 role_check :
 	@( env LC_ALL=C grep -n ' :[a-z]\+`' $(RSTDIR)/*.rst && exit 1 || : )
 	@( env LC_ALL=C grep -n ' `[^`]\+<[a-z][^`]\+`[^_]' $(RSTDIR)/*.rst && exit 1 || : )
+	@( env LC_ALL=C grep -n ':\(ref\|doc\):[^`]' $(RSTDIR)/*.rst && exit 1 || : )
 
 link_check : $(VENV) html
 	@(\
diff --git a/doc/src/fix_srd.rst b/doc/src/fix_srd.rst
index 59044a6e3b..dd080b0d3b 100644
--- a/doc/src/fix_srd.rst
+++ b/doc/src/fix_srd.rst
@@ -81,10 +81,10 @@ used in conjunction with the SRD model.
 These 3 papers give more details on how the SRD model is implemented
 in LAMMPS.  :ref:`(Petersen) <Petersen1>` describes pure SRD fluid
 systems.  :ref:`(Bolintineanu1) <Bolintineanu1>` describes models
-where pure SRD fluids :ref:interact with boundary walls.
+where pure SRD fluids interact with boundary walls.
 :ref:`(Bolintineanu2) <Bolintineanu2>` describes mixture models where
 large colloidal particles are solvated by an SRD fluid.  See the
-``examples/srd`` :ref:directory for sample input scripts.
+``examples/srd`` directory for sample input scripts.
 
 This fix does two things:
 
diff --git a/doc/src/improper_amoeba.rst b/doc/src/improper_amoeba.rst
index 18c7f11080..1a93b0d32a 100644
--- a/doc/src/improper_amoeba.rst
+++ b/doc/src/improper_amoeba.rst
@@ -68,8 +68,8 @@ for more info.
 Related commands
 """"""""""""""""
 
-:doc:`improper_coeff <improper_coeff>`, `improper_harmonic
-:doc:<improper_harmonic>`
+:doc:`improper_coeff <improper_coeff>`,
+:doc:`improper_harmonic <improper_harmonic>`
 
 Default
 """""""