From owner-svn-ports-head@FreeBSD.ORG  Sat Oct 26 10:11:46 2013
Return-Path: <owner-svn-ports-head@FreeBSD.ORG>
Delivered-To: svn-ports-head@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115])
 (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits))
 (No client certificate requested)
 by hub.freebsd.org (Postfix) with ESMTP id 4207BEAE;
 Sat, 26 Oct 2013 10:11:46 +0000 (UTC)
 (envelope-from koobs@FreeBSD.org)
Received: from svn.freebsd.org (svn.freebsd.org
 [IPv6:2001:1900:2254:2068::e6a:0])
 (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
 (No client certificate requested)
 by mx1.freebsd.org (Postfix) with ESMTPS id 2F0CA246B;
 Sat, 26 Oct 2013 10:11:46 +0000 (UTC)
Received: from svn.freebsd.org ([127.0.1.70])
 by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r9QABkQ0012122;
 Sat, 26 Oct 2013 10:11:46 GMT (envelope-from koobs@svn.freebsd.org)
Received: (from koobs@localhost)
 by svn.freebsd.org (8.14.7/8.14.5/Submit) id r9QABkt4012121;
 Sat, 26 Oct 2013 10:11:46 GMT (envelope-from koobs@svn.freebsd.org)
Message-Id: <201310261011.r9QABkt4012121@svn.freebsd.org>
From: Kubilay Kocak <koobs@FreeBSD.org>
Date: Sat, 26 Oct 2013 10:11:46 +0000 (UTC)
To: ports-committers@freebsd.org, svn-ports-all@freebsd.org,
 svn-ports-head@freebsd.org
Subject: svn commit: r331671 - head/Mk
X-SVN-Group: ports-head
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-BeenThere: svn-ports-head@freebsd.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: SVN commit messages for the ports tree for head
 <svn-ports-head.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/svn-ports-head>,
 <mailto:svn-ports-head-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/svn-ports-head>
List-Post: <mailto:svn-ports-head@freebsd.org>
List-Help: <mailto:svn-ports-head-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/svn-ports-head>,
 <mailto:svn-ports-head-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sat, 26 Oct 2013 10:11:46 -0000

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@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.