CVS commit: pkgsrc/doc/guide/files

["David H. Gutteridge" <gutteridge%netbsd.org@localhost>]

Module Name:    pkgsrc
Committed By:   gutteridge
Date:           Sat Jan 13 01:07:38 UTC 2024

Modified Files:
        pkgsrc/doc/guide/files: creating.xml

Log Message:
creating.xml: note including wheel.mk does not pull in py-wheel


To generate a diff of this commit:
cvs rdiff -u -r1.39 -r1.40 pkgsrc/doc/guide/files/creating.xml

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

Modified files:

Index: pkgsrc/doc/guide/files/creating.xml
diff -u pkgsrc/doc/guide/files/creating.xml:1.39 pkgsrc/doc/guide/files/creating.xml:1.40
--- pkgsrc/doc/guide/files/creating.xml:1.39    Sun Oct 29 22:31:01 2023
+++ pkgsrc/doc/guide/files/creating.xml Sat Jan 13 01:07:38 2024
@@ -1,4 +1,4 @@
-<!-- $NetBSD: creating.xml,v 1.39 2023/10/29 22:31:01 gutteridge Exp $ -->
+<!-- $NetBSD: creating.xml,v 1.40 2024/01/13 01:07:38 gutteridge Exp $ -->
 
 <chapter id="creating">
 <title>Creating a new pkgsrc package from scratch</title>
@@ -174,6 +174,11 @@ PYTHON_VERSIONS_INCOMPATIBLE=       27
 <para>
 If the packaged software is a Python module, include
 <filename>../../lang/python/wheel.mk</filename>.
+Note per PEP-518, the minimum and default requirements to create .whl files
+are py-setuptools plus py-wheel; however, there are various other possible
+tools that projects can use. Thus inclusion of <filename>wheel.mk</filename>
+does not imply these defaults are defined as TOOL_DEPENDS. Whatever the project
+specifically requires as packaging tools must be defined in the package Makefile.
 </para>
 
 <para>The package directory should be called