svn commit: r331671 - head/Mk

[Kubilay Kocak]

Author: koobs
Date: Sat Oct 26 10:11:45 2013
New Revision: 331671
URL: http://svnweb.freebsd.org/changeset/ports/331671

Log:
  Mk/bsd.python.mk: Clarify PYTHON_PY3K_PLIST_HACK & PYDISTUTILS_AUTOPLIST usage
  
  Reviewed by:	mva, Johannes Meixner (xmj) via IRC

Modified:
  head/Mk/bsd.python.mk

Modified: head/Mk/bsd.python.mk
==============================================================================
--- head/Mk/bsd.python.mk	Sat Oct 26 09:58:00 2013	(r331670)
+++ head/Mk/bsd.python.mk	Sat Oct 26 10:11:45 2013	(r331671)
@@ -131,15 +131,15 @@ Python_Include_MAINTAINER=	python at FreeBS
 #					  default: setup.py
 #
 # PYDISTUTILS_AUTOPLIST
-#					- Generate the packaging list for distutils based ports
-#					  (including easy_install) automatically.
+#					- Automatically generates the packaging list for ports that use
+#                                         distutils or setuptools (easy_install) when defined. Implies
+#                                         PYTHON_PY3K_PLIST_HACK below.
 #
 # PYTHON_PY3K_PLIST_HACK
-#					- Automatically replaces .pyc and .pyo package list entries
-#					  with the relevant __pycache__ entries for Python 3.x.
-#					  This should only be used for ports, which do not use one
-#					  of Python's default package installation mechanisms and
-#					  which are guaranteed to work with any python version.
+#					- Automatically creates Python 3.x compatible __pycache__ entries
+#                                         when defined. Use this for ports that do *not* use standard
+#                                         Python packaging mechanisms such as distutils or setuptools, and
+#                                         are guaranteed to work with *both* Python 2.x and 3.x.
 #
 # PYDISTUTILS_PKGNAME
 #					- Internal name in the distutils for egg-info.