py-weewx, py-homeassistant: Clarify intent of packages

[Greg Troxel (via pkgsrc-wip) <commit-notify%pkgsrc.org@localhost>]

Module Name:	pkgsrc-wip
Committed By:	Greg Troxel <gdt%lexort.com@localhost>
Pushed By:	gdt
Date:		Sat Feb 1 19:37:21 2025 -0500
Changeset:	1ac06d37f10785696d34e10cecd9eba3e63af0a8

Modified Files:
	py-homeassistant/Makefile
	py-weewx/Makefile

Log Message:
py-weewx, py-homeassistant: Clarify intent of packages

I'm using these to run these two packages on production machines using
pkgsrc stable.

Also, expand comments surrounding homeassistants' dependencies on
compilers; the user needs them when the package is installed, so they
are full dependencies, not build dependencies.

To see a diff of this commit:
https://wip.pkgsrc.org/cgi-bin/gitweb.cgi?p=pkgsrc-wip.git;a=commitdiff;h=1ac06d37f10785696d34e10cecd9eba3e63af0a8

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

diffstat:
 py-homeassistant/Makefile | 21 ++++++++++++++++-----
 py-weewx/Makefile         |  4 ++++
 2 files changed, 20 insertions(+), 5 deletions(-)

diffs:
diff --git a/py-homeassistant/Makefile b/py-homeassistant/Makefile
index 885d02d057..03fef92869 100644
--- a/py-homeassistant/Makefile
+++ b/py-homeassistant/Makefile
@@ -8,6 +8,10 @@ HOMEPAGE=	https://www.home-assistant.io/
 COMMENT=	Meta-package for prereqs for Home Assistant
 LICENSE=	modified-bsd
 
+# This package is intended to be usable with the most recent stable
+# branch; modifications should either be tested in that environment or
+# sent to ${MAINTAINER}.
+
 META_PACKAGE=	yes
 
 # This package is currently tuned for and tested on NetBSD 9 amd64 and
@@ -25,7 +29,10 @@ META_PACKAGE=	yes
 
 # Despite depending on programs as build tools, record a full
 # dependency so that "pkgin ar" after installing this package will not
-# remove e.g. the rust compiler.
+# remove e.g. the rust compiler.  The point is that while that's a
+# build-time dependency in pkgsrc, it's a run-time dependency for this
+# package, because the user will do builds when this package is
+# installed.
 
 # The vast majority of HA components are just python (perhaps a chain
 # of dependencies) and build straightforwardly with "bin/pip install";
@@ -43,18 +50,22 @@ DEPENDS+=	${PYPKGPREFIX}-virtualenv-[0-9]*:../../devel/py-virtualenv
 
 ## BUILD TOOLS
 
-# Builds in the venv will use cmake, pkg-config, and invoke rust and
-# gfortran.									      
-# NB: One must add gfortran's bindir to the PATH for the venv build.
+# Builds in the venv will use cmake, pkg-config, and invoke gcc,
+# fortran and rust.
+# NB: One must add gcc/gfortran's bindir to the PATH for the venv build.
 DEPENDS+=	cmake-[0-9]*:../../devel/cmake
 DEPENDS+=	pkgconf-[0-9]*:../../devel/pkgconf
 
 # GCC
 # \todo Depend on gcc10, because numpy needs it, and venv build
-# scripts will thus require it.
+# scripts will thus require it.  For now, requiring gfortran 10 adds
+# the dependency.
 
 # FORTRAN
 USE_LANGUAGES+=	fortran77
+GFORTRAN_VERSION=	10
+# \todo Revisit the version, so e.g. the version matching native gcc
+# will be used on NetBSD-current.
 .include "../../mk/compiler/gfortran.mk"
 
 RUST_RUNTIME=	yes		# record a dependency
diff --git a/py-weewx/Makefile b/py-weewx/Makefile
index 31783fe1f5..3a96e75294 100644
--- a/py-weewx/Makefile
+++ b/py-weewx/Makefile
@@ -11,6 +11,10 @@ HOMEPAGE=	https://weewx.com/
 COMMENT=	Python-powered template engine and code-generator
 LICENSE=	gnu-gpl-v3
 
+# This package is intended to be usable with the most recent stable
+# branch; modifications should either be tested in that environment or
+# sent to ${MAINTAINER}.
+
 USE_LANGUAGES=
 
 # weewx uses sqlite3