misc/py-cppman: add port: C++ 98/11/14/17/20 manual pages on the terminal

Cppman is a tool that provides C++ manual pages on the terminal. It
acts as a convenient interface to view formatted C++ documentation
directly from cplusplus.com and cppreference.com, allowing developers
to access relevant information quickly without switching to a web
browser.

Features:
- Supports two backends (switch it with cppman -s):
  cplusplus.com
  cppreference.com
- Syntax highlighting support for sections and example source code.
- Usage/Interface similar to the 'man' command
- Hyperlink between manpages (only available when pager=vim)
  - Press Ctrl-] when cursor is on keyword to go forward and Ctrl-T to
    go backward.
  - You can also double-click on keyword to go forward and right-click
    to go backward.
- Frequently update to support cplusplus.com.

WWW: https://github.com/aitjcize/cppman

Co-authored-by: freebsd@fron.io

PR:		284157
Reported by:	freebsd@fron.io (initial version)

6 files changed, 94 insertions, 0 deletions

diff --git a/misc/Makefile b/misc/Makefile
index e266bfe77882..58ef922599a5 100644
--- a/misc/Makefile
+++ b/misc/Makefile
@@ -430,6 +430,7 @@
     SUBDIR += py-colorbrewer
     SUBDIR += py-colored
     SUBDIR += py-colorzero
+    SUBDIR += py-cppman
     SUBDIR += py-crudini
     SUBDIR += py-datasets
     SUBDIR += py-detecta
diff --git a/misc/py-cppman/Makefile b/misc/py-cppman/Makefile
new file mode 100644
index 000000000000..4b92dd4f495a
--- /dev/null
+++ b/misc/py-cppman/Makefile
@@ -0,0 +1,41 @@
+PORTNAME=	cppman
+PORTVERSION=	0.5.9
+CATEGORIES=	misc python
+MASTER_SITES=	PYPI
+PKGNAMEPREFIX=	${PYTHON_PKGNAMEPREFIX}
+
+MAINTAINER=	tagattie@FreeBSD.org
+COMMENT=	C++ 98/11/14/17/20 manual pages on the terminal
+WWW=		https://github.com/aitjcize/cppman
+
+LICENSE=	GPLv3
+LICENSE_FILE=	${WRKSRC}/COPYING
+
+RUN_DEPENDS=	${PYTHON_PKGNAMEPREFIX}beautifulsoup>=4.13.3:www/py-beautifulsoup@${PY_FLAVOR} \
+		${PYTHON_PKGNAMEPREFIX}html5lib>=1.1:www/py-html5lib@${PY_FLAVOR} \
+		${PYTHON_PKGNAMEPREFIX}lxml5>=5.3.2:devel/py-lxml5@${PY_FLAVOR} \
+		${PYTHON_PKGNAMEPREFIX}six>=1.17.0:devel/py-six@${PY_FLAVOR} \
+		${PYTHON_PKGNAMEPREFIX}soupsieve>=2.6:www/py-soupsieve@${PY_FLAVOR} \
+		${PYTHON_PKGNAMEPREFIX}typing-extensions>=4.13.1:devel/py-typing-extensions@${PY_FLAVOR} \
+		${PYTHON_PKGNAMEPREFIX}webencodings>=0.5.1:converters/py-webencodings@${PY_FLAVOR} \
+		vim:editors/vim \
+		bash:shells/bash
+
+USES=		python shebangfix
+
+USE_PYTHON=	autoplist concurrent distutils
+
+SHEBANG_FILES=	bin/cppman \
+		cppman/lib/pager.sh
+
+NO_ARCH=	yes
+
+PORTDOCS=	AUTHORS ChangeLog README.rst
+
+OPTIONS_DEFINE=	DOCS
+
+post-install-DOCS-on:
+	@${MKDIR} ${STAGEDIR}${DOCSDIR}
+	${INSTALL_MAN} ${PORTDOCS:S|^|${WRKSRC}/|} ${STAGEDIR}${DOCSDIR}
+
+.include <bsd.port.mk>
diff --git a/misc/py-cppman/distinfo b/misc/py-cppman/distinfo
new file mode 100644
index 000000000000..c0f5932d5a3b
--- /dev/null
+++ b/misc/py-cppman/distinfo
@@ -0,0 +1,3 @@
+TIMESTAMP = 1751778661
+SHA256 (cppman-0.5.9.tar.gz) = 15a4e40ab025b4dcec5a73a50df26b7ddaef7c148fcb197940fff2484f9e9903
+SIZE (cppman-0.5.9.tar.gz) = 1644343
diff --git a/misc/py-cppman/files/patch-setup.py b/misc/py-cppman/files/patch-setup.py
new file mode 100644
index 000000000000..23eb8489cf39
--- /dev/null
+++ b/misc/py-cppman/files/patch-setup.py
@@ -0,0 +1,15 @@
+--- setup.py.orig	2025-07-22 07:20:26 UTC
++++ setup.py
+@@ -9,10 +9,9 @@ _data_files = [
+         ]
+ 
+ _data_files = [
+-        ('share/doc/cppman', ['README.rst', 'AUTHORS', 'COPYING', 'ChangeLog']),
+         ('share/man/man1', ['misc/cppman.1']),
+-        ('share/bash-completion/completions', ['misc/completions/cppman.bash']),
+-        ('share/zsh/vendor-completions/', ['misc/completions/zsh/_cppman']),
++        ('etc/bash_completion.d', ['misc/completions/cppman.bash']),
++        ('share/zsh/site-functions/', ['misc/completions/zsh/_cppman']),
+         ('share/fish/vendor_completions.d/', ['misc/completions/fish/cppman.fish'])
+         ]
+ 
diff --git a/misc/py-cppman/pkg-descr b/misc/py-cppman/pkg-descr
new file mode 100644
index 000000000000..fd38305caaf9
--- /dev/null
+++ b/misc/py-cppman/pkg-descr
@@ -0,0 +1,18 @@
+Cppman is a tool that provides C++ manual pages on the terminal. It
+acts as a convenient interface to view formatted C++ documentation
+directly from cplusplus.com and cppreference.com, allowing developers
+to access relevant information quickly without switching to a web
+browser.
+
+Features:
+- Supports two backends (switch it with cppman -s):
+  cplusplus.com
+  cppreference.com
+- Syntax highlighting support for sections and example source code.
+- Usage/Interface similar to the 'man' command
+- Hyperlink between manpages (only available when pager=vim)
+  - Press Ctrl-] when cursor is on keyword to go forward and Ctrl-T to
+    go backward.
+  - You can also double-click on keyword to go forward and right-click
+    to go backward.
+- Frequently update to support cplusplus.com.
diff --git a/misc/py-cppman/pkg-message b/misc/py-cppman/pkg-message
new file mode 100644
index 000000000000..a0a6582fc08d
--- /dev/null
+++ b/misc/py-cppman/pkg-message
@@ -0,0 +1,16 @@
+[
+{ type: install
+  message: <<EOM
+To support vim on nvim as pager, cppman needs fdescfs(5)
+to be mounted on /dev/fd.
+
+If /dev/fd is not already mounted:
+
+	mount -t fdescfs fdesc /dev/fd
+
+To make it permanent, add the following line to /etc/fstab:
+
+	fdesc	/dev/fd		fdescfs		rw	0	0
+EOM
+}
+]