sysutils/dtrace-toolkit: Fix manual pages installation

- Install a man.conf for the toolkit's manual pages.
- Explain in pkg-message
- Some additional cosmetic changes

PR:		262679
Reported by:	grahamperrin@

sysutils/dtrace-toolkit/Makefile

@@ -2,7 +2,7 @@
 
 PORTNAME=	dtrace-toolkit
 PORTVERSION=	1.0
-PORTREVISION=	6
+PORTREVISION=	7
 CATEGORIES=	sysutils
 
 MAINTAINER=	0mp@FreeBSD.org
@@ -74,8 +74,11 @@ sh_CMD=		${SH}
 perl_OLD_CMD=	\\./perl
 ruby_OLD_CMD=	\\./ruby
 
+NO_ARCH=	yes
 NO_BUILD=	yes
 
+SUB_FILES=	pkg-message
+
 .include <bsd.port.options.mk>
 
 .if ${OPSYS} == FreeBSD
@@ -94,8 +97,9 @@ do-install:
 	${RLN} ${STAGEDIR}${DATADIR}/Apps/shellsnoop ${STAGEDIR}${PREFIX}/bin/shellsnoop
 
 .for MANPAGE in dtruss hotkernel procsystime opensnoop shellsnoop
-	${INSTALL_MAN} ${WRKSRC}/Man/man1m/${MANPAGE}.1m \
+	${RLN} ${STAGEDIR}${DATADIR}/Man/man1m/${MANPAGE}.1m \
 		${STAGEDIR}${MAN1PREFIX}/man/man1/${MANPAGE}.1
 .endfor
+	${ECHO_CMD} 'MANPATH ${DATADIR}/Man' > ${STAGEDIR}${PREFIX}/etc/man.d/${PORTNAME}.conf
 
 .include <bsd.port.mk>

sysutils/dtrace-toolkit/files/pkg-message.in

@@ -0,0 +1,23 @@
+[
+{ type: install
+  message: <<EOM
+Many of the DTraceToolkit scripts do not work on FreeBSD at the moment,
+usually because:
+- They are using Solaris-specific features
+- They use probes which are not supported yet on FreeBSD
+
+Some popular scripts are installed at:
+
+    %%PREFIX%%/bin
+
+The rest of the scripts and other toolkit files can be found in:
+
+    %%DATADIR%%
+
+To view the manual pages in the "1m" manual section,
+the section has to be specified explicitly, e.g.:
+
+    man -s 1m fddist
+EOM
+}
+]

sysutils/dtrace-toolkit/pkg-plist

@@ -1024,3 +1024,4 @@ man/man1/shellsnoop.1.gz
 %%DATADIR%%/statsnoop
 %%DATADIR%%/CDDL
 %%DATADIR%%/README.md
+etc/man.d/dtrace-toolkit.conf