diff --git a/textproc/py-sphinx-autoapi/Makefile b/textproc/py-sphinx-autoapi/Makefile index 988b18b5775c..9b7d96ccaaa0 100644 --- a/textproc/py-sphinx-autoapi/Makefile +++ b/textproc/py-sphinx-autoapi/Makefile @@ -1,26 +1,27 @@ PORTNAME= sphinx-autoapi DISTVERSION= 3.8.0 CATEGORIES= textproc python MASTER_SITES= PYPI PKGNAMEPREFIX= ${PYTHON_PKGNAMEPREFIX} DISTNAME= sphinx_autoapi-${DISTVERSION} MAINTAINER= ports@FreeBSD.org COMMENT= Sphinx API documentation generator -WWW= https://sphinx-autoapi.readthedocs.io/ +WWW= https://sphinx-autoapi.readthedocs.io/en/latest/ \ + https://github.com/readthedocs/sphinx-autoapi LICENSE= MIT LICENSE_FILE= ${WRKSRC}/LICENSE.rst BUILD_DEPENDS= ${PYTHON_PKGNAMEPREFIX}flit-core>=3.2<4:devel/py-flit-core@${PY_FLAVOR} RUN_DEPENDS= ${PYTHON_PKGNAMEPREFIX}astroid>=3.0:devel/py-astroid@${PY_FLAVOR} \ - ${PYTHON_PKGNAMEPREFIX}Jinja2>0:devel/py-Jinja2@${PY_FLAVOR} \ - ${PYTHON_PKGNAMEPREFIX}sphinx>=7.4.0,1:textproc/py-sphinx@${PY_FLAVOR} \ - ${PYTHON_PKGNAMEPREFIX}pyyaml>=0:devel/py-pyyaml@${PY_FLAVOR} + ${PYTHON_PKGNAMEPREFIX}Jinja2>=0:devel/py-Jinja2@${PY_FLAVOR} \ + ${PYTHON_PKGNAMEPREFIX}pyyaml>=0:devel/py-pyyaml@${PY_FLAVOR} \ + ${PYTHON_PKGNAMEPREFIX}sphinx>=7.4.0,1:textproc/py-sphinx@${PY_FLAVOR} USES= python USE_PYTHON= autoplist concurrent pep517 NO_ARCH= yes .include diff --git a/textproc/py-sphinx-autoapi/pkg-descr b/textproc/py-sphinx-autoapi/pkg-descr index 7620abc23161..57bae38fff57 100644 --- a/textproc/py-sphinx-autoapi/pkg-descr +++ b/textproc/py-sphinx-autoapi/pkg-descr @@ -1,3 +1,6 @@ -Sphinx AutoAPI provides "autodoc" style documentation for multiple -programming languages without needing to load, run, or import the -project being documented. +Sphinx AutoAPI is a Sphinx extension for generating complete API documentation +without needing to load, run, or import the project being documented. + +In contrast to the traditional Sphinx autodoc, which requires manual authoring +and uses code imports, AutoAPI finds and generates documentation by parsing +source code.