From sacadmin Thu Sep 22 11:22:02 2005
Received: from sunmail3.sfbay.sun.com (sunmail3.SFBay.Sun.COM [129.149.247.180])
	by sac.sfbay.sun.com (8.12.9+Sun/8.12.9) with ESMTP id j8MIM2Eu014003
	for <psarc@sac.eng.sun.com>; Thu, 22 Sep 2005 11:22:02 -0700 (PDT)
Received: from sfbaymail2sca.sfbay.sun.com (sfbaymail2sca.SFBay.Sun.COM [129.145.155.42])
	by sunmail3.sfbay.sun.com (8.11.7p1+Sun/8.11.7/ENSMAIL,v2.2) with ESMTP id j8MILhh19620
	for <psarc@sun.com>; Thu, 22 Sep 2005 11:21:54 -0700 (PDT)
Received: from phys-bos-2.sfbay.sun.com (phys-bos-2.SFBay.Sun.COM [129.146.14.24])
	by sfbaymail2sca.sfbay.sun.com (8.12.10+Sun/8.12.10/ENSMAIL,v2.2) with ESMTP id j8MILhao004723
	for <@mailhost.sfbay.sun.com:psarc@sun.com>; Thu, 22 Sep 2005 11:21:43 -0700 (PDT)
Received: from localhost (d-mpk14-91-125.SFBay.Sun.COM [129.146.91.125])
 by bos-mail1.sfbay.sun.com
 (Sun Java System Messaging Server 6.2 HotFix 0.05 (built Jan 10 2005))
 with SMTP id <0IN800J8NDO6F560@bos-mail1.sfbay.sun.com> for psarc@sun.com
 (ORCPT psarc@sun.com); Thu, 22 Sep 2005 11:21:43 -0700 (PDT)
Date: Thu, 22 Sep 2005 11:19:55 -0700 (PDT)
From: Rich Burridge <richb@bos-mail1.sfbay.sun.com>
Subject: PSARC 2005/555 - Python "vendor-packages" support
To: psarc@sun.com
Cc: William.Walker@sun.com
Reply-to: Rich Burridge <richb@bos-mail1.sfbay.sun.com>
Message-id: <0IN800J8ODO6F560@bos-mail1.sfbay.sun.com>
MIME-version: 1.0
X-Mailer: dtmail 1.3.0 @(#)CDE Version 1.7_16 SunOS 5.11 i86pc i386
Content-type: TEXT/plain; charset=us-ascii
Content-MD5: Ct5UxUS6Xz8qPu9HG1wbiQ==
Status: RO
Content-Length: 6067


I'm sponsoring this fast-track for myself on behalf of the Orca project.

The proposal is included below. It can also be found at:

   http://sac.sfbay.sun.com/arc/PSARC/2005/555/proposal.txt

The requested release binding is minor.

Timer set for 29th September 2005.

--
Rich Burridge                       Email:     rich.burridge@Sun.COM
Sun Microsystems Inc. (MPK14-260),  Phone:     +1.650.786.5188
4150 Network Circle,                AIM/YAHOO: RicBurridge
Santa Clara, CA 95054               Blog:      http://blogs.sun.com/richb


--------------------------------------------------------------------------

[Revision 1: Thu Sep 22 11:12:12 PDT 2005]

Template Version: @(#)sac_nextcase 1.55 08/11/04 SMI
Copyright 2005 Sun Microsystems, Inc.

1. Introduction
    1.1. Project/Component Working Name:

        Python "vendor-packages" support.

    1.2. Name of Document Author/Supplier:

        Author:  Rich Burridge

    1.3  Date of This Document:

        22 September 2005
        

    1.4. Technical Description

         Modification of Solaris Python 2.4.x, to automatically look for 
         vendor supplied Python library and application files under the
         /usr/lib/python2.4/vendor-packages directory


2. Summary

   This proposal is to adjust the Solaris Python 2.4.x distribution
   to allow it to automatically search in
   /usr/lib/python2.4/vendor-packages for vendor supplied Python
   files.

   The project team will also work with the Python community to get
   this change adopted for a future community version of Python.

   The requested release binding is minor.


3. Background

   A recent case (PSARC 2005/532 [1]) requested the migration of Python
   from /usr/sfw to /usr and an upgrade from v2.3.x to v2.4.x. The 
   rational behind this was so that the Orca screen reader 
   (LSARC 2005/504 [2]) and various Python support libraries that it needs
   (LSARC 2005/506 [3]) could be installed under

     /usr/lib/python2.4/site-packages

   rather than under

     /usr/sfw/lib/python2.3/site-packages

   as there is an active migration of applications away from /usr/sfw.

   Feedback on this proposal told us that the "site-packages" directory
   is an inappropriate place to put files that we (as a vendor) deliver, 
   just as "site_perl" would be inappropriate if we were delivering Perl 
   files. 

   Perl's solution is to have a "vendor_perl" directory for vendor
   delivered files. There is currently no such equivalent in Python.

   A "/usr/lib/python2.4/vendor-packages" directory for these Python
   files could easily be created, but unfortunately that doesn't "just
   work". In other words, it's not one of the known places that Python 
   will look for library or application Python files. Each Python
   application that wanted to use those files would have to set PYTHONPATH 
   and make sure that "/usr/lib/python2.4/vendor-packages" was on it.


4. Proposed Solution

   To adjust the Solaris Python 2.4.x distribution (by way of a patch
   automatically applied at build time), so that Python will append

     /usr/lib/python2.4/vendor-packages

   to the end of the list of known places where it automatically looks 
   for library and application files

   To work with the Python community to get this proposed change integrated
   into a future generic Python distribution, so that we (Sun) don't have
   to have to make any changes to provide this functionality.

   To that end we solicited feedback from the Python community, via one
   of their mailing lists [4]. This didn't generate a definitive answer, 
   so Guido van Rossum, (the creator of Python) was contacted. He replied 
   that he thought this was a reasonable request and that we should use 
   the SourceForge patch manager for the Python project to upload the 
   patch that provides this functionality, and then inform the members 
   of the python-dev mailing list. We have done this [5] [6]. 

   We plan to continue working with the Python community to ensure that 
   this change is integrated into a future Python release.

 
5. Interface Stability

    Python, as an Open Source effort, is revised by a group external to
    Sun.  This group maintains compatibility with previous releases of
    Python and defines its reference syntax in their provided
    documentation [2].

    INTERFACE                           |   CLASSIFICATION
    ------------------------------------+-----------------
    Python 2.4.x code base              |   External
                                        |
                 directory layout       |   Evolving
                                        |
    /usr/lib/python2.4/vendor-packages  |   Evolving


6. Documentation

    The Python documentation will continue to be provided in
    the form of an external manual page, python.1, which contains 
    pointers to the complete Python documentation on the Internet.
 
    It will also be updated to reflect that Sun supplied Python
    files are located under /usr/lib/python2.4/vendor-packages.
 

7. Resources and Schedule
    7.4. Steering Committee requested information
          7.4.1. Consolidation C-team Name:

              JDS

    7.5. ARC review type: FastTrack


8. References

   [1] PSARC/2005/532 - Python migration from /usr/sfw to /usr and upgrade
                        to v2.4.x

   [2] LSARC/2005/504 - Orca Screen Reader/Magnifier for the JDS Desktop

   [3] LSARC/2005/506 - Support Libraries for the Orca Screen Reader/Magnifier

   [4] Informing the Python community of the request for a "vendor-packages"
       directory and asking for feedback. 
       http://mail.python.org/pipermail/python-list/2005-September/300029.html

   [5] Patch supplied to the SourceForge patch manager for Python
       http://sourceforge.net/tracker/index.php?func=detail&aid=1298835&group_id=5470&atid=305470

   [6] Informing the Python development community of the request for a 
       "vendor-packages" directory. 

       http://mail.python.org/pipermail/python-dev/2005-September/056682.html


From sacadmin Fri Sep 23 07:31:03 2005
Received: from sunmail1brm.Central.Sun.COM (sunmail1brm.Central.Sun.COM [129.147.62.17])
	by sac.sfbay.sun.com (8.12.9+Sun/8.12.9) with ESMTP id j8NEV2Eu008583
	for <psarc@sac.eng.Sun.COM>; Fri, 23 Sep 2005 07:31:02 -0700 (PDT)
Received: from sfbaymail2sca.sfbay.sun.com (sfbaymail2sca.SFBay.Sun.COM [129.145.155.42])
	by sunmail1brm.Central.Sun.COM (8.11.7p1+Sun/8.11.7/ENSMAIL,v2.2) with ESMTP id j8NEV1n02158
	for <psarc@sun.com>; Fri, 23 Sep 2005 08:31:01 -0600 (MDT)
Received: from phys-bos-2.sfbay.sun.com (phys-bos-2.SFBay.Sun.COM [129.146.14.24])
	by sfbaymail2sca.sfbay.sun.com (8.12.10+Sun/8.12.10/ENSMAIL,v2.2) with ESMTP id j8NEV1ao020613
	for <@mailhost.sfbay.sun.com:psarc@sun.com>; Fri, 23 Sep 2005 07:31:01 -0700 (PDT)
Received: from [129.146.91.125] (d-mpk14-91-125.SFBay.Sun.COM [129.146.91.125])
 by bos-mail1.sfbay.sun.com
 (Sun Java System Messaging Server 6.2 HotFix 0.05 (built Jan 10 2005))
 with ESMTP id <0IN900HTAXNPAQ10@bos-mail1.sfbay.sun.com> for psarc@sun.com
 (ORCPT psarc@sun.com); Fri, 23 Sep 2005 07:31:01 -0700 (PDT)
Date: Fri, 23 Sep 2005 07:29:12 -0700
From: Rich Burridge <rich.burridge@sun.com>
Subject: Re: PSARC 2005/555 - Python "vendor-packages" support
To: psarc@sun.com
Cc: Willie Walker <William.Walker@sun.com>
Message-id: <43341138.6030506@sun.com>
MIME-version: 1.0
Content-type: text/plain; charset=ISO-8859-1; format=flowed
Content-transfer-encoding: 7bit
X-Accept-Language: en-us, en
User-Agent: Mozilla Thunderbird 1.0.2 (X11/20050512)
Status: RO
Content-Length: 584


After feedback on this request from members of the Python development
community; see:

   http://mail.python.org/pipermail/python-dev/2005-September/056697.html
   http://mail.python.org/pipermail/python-dev/2005-September/056699.html

the fast-track proposal has been updated to make:

   /usr/lib/python2.4/site-packages/vendor-packages.pth

the exposed interface rather than the

   /usr/lib/python2.4/vendor-packages

directory.

The proposal in the case directory:

   http://sac.sfbay.sun.com/arc/PSARC/2005/555/proposal.txt

contains this one line change (via a change bar).


From sacadmin Fri Sep 23 08:37:33 2005
Received: from sunmail3.sfbay.sun.com (sunmail3.SFBay.Sun.COM [129.149.247.180])
	by sac.sfbay.sun.com (8.12.9+Sun/8.12.9) with ESMTP id j8NFbXEu012009
	for <psarc@sac.eng.sun.com>; Fri, 23 Sep 2005 08:37:33 -0700 (PDT)
Received: from sfbaymail1sca.SFBay.Sun.COM (sfbaymail1sca.SFBay.Sun.COM [129.145.154.35])
	by sunmail3.sfbay.sun.com (8.11.7p1+Sun/8.11.7/ENSMAIL,v2.2) with ESMTP id j8NFbWh14657
	for <psarc@sun.com>; Fri, 23 Sep 2005 08:37:32 -0700 (PDT)
Received: from phys-mpk-1 (phys-mpk-1.SFBay.Sun.COM [129.146.11.81])
	by sfbaymail1sca.SFBay.Sun.COM (8.12.10+Sun/8.12.10/ENSMAIL,v2.2) with ESMTP id j8NFbWf8014821
	for <psarc@sun.com>; Fri, 23 Sep 2005 08:37:32 -0700 (PDT)
Received: from conversion-daemon.mpk-mail1.sfbay.sun.com by
 mpk-mail1.sfbay.sun.com
 (iPlanet Messaging Server 5.2 HotFix 1.24 (built Dec 19 2003))
 id <0INA00D010M1CD@mpk-mail1.sfbay.sun.com>
 (original mail from ed.gould@sun.com) for psarc@sun.com; Fri,
 23 Sep 2005 08:37:31 -0700 (PDT)
Received: from [192.168.0.10]
 (vpn-129-150-29-165.SFBay.Sun.COM [129.150.29.165]) by mpk-mail1.sfbay.sun.com
 (iPlanet Messaging Server 5.2 HotFix 1.24 (built Dec 19 2003))
 with ESMTP id <0INA004S30Q2BW@mpk-mail1.sfbay.sun.com>; Fri,
 23 Sep 2005 08:37:15 -0700 (PDT)
Date: Fri, 23 Sep 2005 08:37:14 -0700
From: Ed Gould <ed.gould@sun.com>
Subject: Re: PSARC 2005/555 - Python "vendor-packages" support
In-reply-to: <43341138.6030506@sun.com>
To: Rich Burridge <Rich.Burridge@sun.com>
Cc: psarc@sun.com, Willie Walker <William.Walker@sun.com>
Message-id: <92fc56dc07cd892281424edb86c5a1ee@sun.com>
MIME-version: 1.0 (Apple Message framework v622)
X-Mailer: Apple Mail (2.622)
Content-type: text/plain; charset=US-ASCII; format=flowed
Content-transfer-encoding: 7BIT
References: <43341138.6030506@sun.com>
Status: RO
Content-Length: 742

On Sep 23, 2005, at 7:29, Rich Burridge wrote:
> After feedback on this request from members of the Python development
> community; see:
>
>   
> http://mail.python.org/pipermail/python-dev/2005-September/056697.html
>   
> http://mail.python.org/pipermail/python-dev/2005-September/056699.html
>
> the fast-track proposal has been updated to make:
>
>   /usr/lib/python2.4/site-packages/vendor-packages.pth
>
> the exposed interface rather than the
>
>   /usr/lib/python2.4/vendor-packages
>
> directory.

 From the emails on the Python list, it seems to me that both the file 
(vendor-packates.pth)) and the target directory 
(/usr/lib/python2.4/vendor-packages) are interfaces.  The latter might 
be Private of some sort, however.

	--Ed


From sacadmin Fri Sep 23 12:55:11 2005
Received: from sunmail2.sfbay.sun.com (sunmail2.SFBay.Sun.COM [129.149.246.180])
	by sac.sfbay.sun.com (8.12.9+Sun/8.12.9) with ESMTP id j8NJtBEu029948
	for <psarc@sac.eng.sun.com>; Fri, 23 Sep 2005 12:55:11 -0700 (PDT)
Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.149.246.28])
	by sunmail2.sfbay.sun.com (8.11.7p1+Sun/8.11.7/ENSMAIL,v2.2) with ESMTP id j8NJtBP28905
	for <@sunmail2.sfbay.sun.com:psarc@sun.com>; Fri, 23 Sep 2005 12:55:11 -0700 (PDT)
Received: from pmxchannel-daemon.nwk-avmta-1.sfbay.Sun.COM by
 nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2 (built Dec  2 2004))
 id <0INA00801CNZFO00@nwk-avmta-1.sfbay.Sun.COM> for psarc@sun.com
 (ORCPT psarc@sun.com); Fri, 23 Sep 2005 12:55:11 -0700 (PDT)
Received: from sfbaymail1sca.SFBay.Sun.COM ([129.145.154.35])
 by nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2 (built Dec  2 2004))
 with ESMTP id <0INA001AGCNZN620@nwk-avmta-1.sfbay.Sun.COM> for psarc@sun.com
 (ORCPT psarc@sun.com); Fri, 23 Sep 2005 12:55:11 -0700 (PDT)
Received: from phys-bos-2.sfbay.sun.com
 (phys-bos-2.SFBay.Sun.COM [129.146.14.24])	by sfbaymail1sca.SFBay.Sun.COM
 (8.12.10+Sun/8.12.10/ENSMAIL,v2.2) with ESMTP id j8NJtBf8028441	for
 <@mailhost.sfbay.sun.com:psarc@sun.com>; Fri, 23 Sep 2005 12:55:11 -0700 (PDT)
Received: from [129.146.91.125] (d-mpk14-91-125.SFBay.Sun.COM [129.146.91.125])
 by bos-mail1.sfbay.sun.com
 (Sun Java System Messaging Server 6.2 HotFix 0.05 (built Jan 10 2005))
 with ESMTP id <0INA00HIKCNYAT70@bos-mail1.sfbay.sun.com> for psarc@sun.com
 (ORCPT psarc@sun.com); Fri, 23 Sep 2005 12:55:10 -0700 (PDT)
Date: Fri, 23 Sep 2005 12:53:21 -0700
From: Rich Burridge <rich.burridge@sun.com>
Subject: Re: PSARC 2005/555 - Python "vendor-packages" support
In-reply-to: <92fc56dc07cd892281424edb86c5a1ee@sun.com>
To: Ed Gould <Ed.Gould@sun.com>
Cc: psarc@sun.com, Willie Walker <William.Walker@sun.com>
Message-id: <43345D31.7000303@sun.com>
MIME-version: 1.0
Content-type: text/plain; charset=ISO-8859-1; format=flowed
Content-transfer-encoding: 7BIT
X-Accept-Language: en-us, en
X-PMX-Version: 5.0.3.165339
References: <43341138.6030506@sun.com>
 <92fc56dc07cd892281424edb86c5a1ee@sun.com>
User-Agent: Mozilla Thunderbird 1.0.2 (X11/20050512)
Status: RO
Content-Length: 579

Ed Gould wrote:
>  From the emails on the Python list, it seems to me that both the file 
> (vendor-packates.pth)) and the target directory 
> (/usr/lib/python2.4/vendor-packages) are interfaces.  The latter might 
> be Private of some sort, however.

Good point. I've added an entry to the interface table for
"/usr/lib/python2.4/vendor-packages" and marked it "Sun Private"
so as to avoid the need for contracts (thanks Danek).

This change has been applied to:

   http://sac.eng/arc/PSARC/2005/555/proposal.txt

in the case directory (and marked with a charge bar).

Thanks.

From sacadmin Thu Sep 29 07:33:10 2005
Received: from sunmail2.sfbay.sun.com (sunmail2.SFBay.Sun.COM [129.149.246.180])
	by sac.sfbay.sun.com (8.12.9+Sun/8.12.9) with ESMTP id j8TEXAEu009781
	for <psarc@sac.eng.sun.com>; Thu, 29 Sep 2005 07:33:10 -0700 (PDT)
Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.149.246.28])
	by sunmail2.sfbay.sun.com (8.11.7p1+Sun/8.11.7/ENSMAIL,v2.2) with ESMTP id j8TEXAN25659
	for <@sunmail2.sfbay.sun.com:psarc@sun.com>; Thu, 29 Sep 2005 07:33:10 -0700 (PDT)
Received: from pmxchannel-daemon.nwk-avmta-1.sfbay.Sun.COM by
 nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2 (built Dec  2 2004))
 id <0INL006011RAYD00@nwk-avmta-1.sfbay.Sun.COM> for psarc@sun.com
 (ORCPT psarc@sun.com); Thu, 29 Sep 2005 07:33:10 -0700 (PDT)
Received: from sfbaymail1sca.SFBay.Sun.COM ([129.145.154.35])
 by nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2 (built Dec  2 2004))
 with ESMTP id <0INL007O51R9OPC0@nwk-avmta-1.sfbay.Sun.COM> for psarc@sun.com
 (ORCPT psarc@sun.com); Thu, 29 Sep 2005 07:33:09 -0700 (PDT)
Received: from phys-bos-2.sfbay.sun.com
 (phys-bos-2.SFBay.Sun.COM [129.146.14.24])	by sfbaymail1sca.SFBay.Sun.COM
 (8.12.10+Sun/8.12.10/ENSMAIL,v2.2) with ESMTP id j8TEX9f8011315	for
 <@mailhost.sfbay.sun.com:psarc@sun.com>; Thu, 29 Sep 2005 07:33:09 -0700 (PDT)
Received: from [129.146.91.125] (d-mpk14-91-125.SFBay.Sun.COM [129.146.91.125])
 by bos-mail1.sfbay.sun.com
 (Sun Java System Messaging Server 6.2 HotFix 0.05 (built Jan 10 2005))
 with ESMTP id <0INL00K341R9IV20@bos-mail1.sfbay.sun.com> for psarc@sun.com
 (ORCPT psarc@sun.com); Thu, 29 Sep 2005 07:33:09 -0700 (PDT)
Date: Thu, 29 Sep 2005 07:31:13 -0700
From: Rich Burridge <rich.burridge@sun.com>
Subject: Re: PSARC 2005/555 - Python "vendor-packages" support
To: psarc@sun.com
Cc: Willie Walker <William.Walker@sun.com>
Message-id: <433BFAB1.701@sun.com>
MIME-version: 1.0
Content-type: text/plain; charset=ISO-8859-1; format=flowed
Content-transfer-encoding: 7BIT
X-Accept-Language: en-us, en
X-PMX-Version: 5.0.3.165339
User-Agent: Mozilla Thunderbird 1.0.2 (X11/20050512)
Status: RO
Content-Length: 96


Per the decision at yesterdays PSARC meeting, this fast-track has been marked
closed approved.

