diff --git a/textproc/py-m2r/Makefile b/textproc/py-m2r/Makefile
index 9eed700ef05..ff6fee52388 100644
--- a/textproc/py-m2r/Makefile
+++ b/textproc/py-m2r/Makefile
@@ -1,6 +1,8 @@
 COMMENT =		markdown to reStructuredText converter
 
+# github repo archived, upstream suggests forking
 MODPY_EGG_VERSION =	0.3.1
+REVISION =		0
 
 DISTNAME =		m2r-${MODPY_EGG_VERSION}
 PKGNAME =		py-${DISTNAME}
@@ -16,7 +18,7 @@ MODPY_PI =		Yes
 MODULES =		lang/python
 MODPY_PYBUILD =		setuptools
 
-RUN_DEPENDS =		textproc/py-mistune${MODPY_FLAVOR} \
+RUN_DEPENDS =		textproc/py-mistune${MODPY_FLAVOR}<2 \
 			textproc/py-docutils${MODPY_FLAVOR}
 
 FLAVORS =		python3
diff --git a/textproc/py-mistune/Makefile b/textproc/py-mistune/Makefile
index 4a693428d4a..c49b9f0087a 100644
--- a/textproc/py-mistune/Makefile
+++ b/textproc/py-mistune/Makefile
@@ -1,5 +1,7 @@
 COMMENT =		markdown parser for Python
 
+# this is the newest compatible with py-m2r which (as of 0.3.1)
+# needs mistune < 2.0
 MODPY_EGG_VERSION =	0.8.4
 DISTNAME =		mistune-${MODPY_EGG_VERSION}
 PKGNAME =		py-${DISTNAME}