From jyri@sac.sfbay.sun.com Mon Jan  5 18:26:17 2009
Received: from sunmail4.singapore.sun.com (sunmail4.Singapore.Sun.COM [129.158.71.19])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n062QG8H001921
	for <LSARC-ext@sac.sfbay.sun.com>; Mon, 5 Jan 2009 18:26:16 -0800 (PST)
Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11])
	by sunmail4.singapore.sun.com (8.13.4+Sun/8.13.3/ENSMAIL,v2.2) with ESMTP id n062Q1QM002531;
	Tue, 6 Jan 2009 10:26:15 +0800 (SGT)
Received: from pmxchannel-daemon.brm-avmta-1.central.sun.com by
 brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0KD100K072RQWC00@brm-avmta-1.central.sun.com>; Mon,
 05 Jan 2009 19:26:14 -0700 (MST)
Received: from dm-sfbay-01.sfbay.sun.com ([129.145.155.118])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KD100AUC2RQG1A0@brm-avmta-1.central.sun.com>; Mon,
 05 Jan 2009 19:26:14 -0700 (MST)
Received: from sac.sfbay.sun.com (new-sac.SFBay.Sun.COM [129.146.175.65])
	by dm-sfbay-01.sfbay.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2)
 with ESMTP id n062QC7u019014; Mon, 05 Jan 2009 18:26:12 -0800 (PST)
Received: from sac.sfbay.sun.com (localhost [127.0.0.1])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n062QB4K001916; Mon,
 05 Jan 2009 18:26:11 -0800 (PST)
Received: (from jyri@localhost)	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8/Submit)
 id n062QAQ8001912; Mon, 05 Jan 2009 18:26:10 -0800 (PST)
Date: Mon, 05 Jan 2009 18:26:10 -0800 (PST)
From: Jyri Virkki <jyri@sac.sfbay.sun.com>
Subject: Ruby Gem Update [LSARC/2009/005 FastTrack timeout 01/13/2009]
To: LSARC-ext@sun.com
Cc: amanda.waite@sun.com, webstack-discuss@opensolaris.org
Message-id: <200901060226.n062QAQ8001912@sac.sfbay.sun.com>
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
Status: RO
Content-Length: 5619



I am sponsoring this case for Amanda Waite for the Web Stack Project.
Timeout is set to 01/13/2009


Template Version: @(#)sac_nextcase %I% %G% SMI
This information is Copyright 2009 Sun Microsystems
1. Introduction
    1.1. Project/Component Working Name:
	 Ruby Gem Update
    1.2. Name of Document Author/Supplier:
	 Author:  Amanda Waite
    1.3  Date of This Document:
	05 January, 2009
4. Technical Description
Ruby Gem Update
Amanda Waite <amanda.waite@sun.com>

05 January 2008

1. Summary and motivation

        1.1. Introduction

        This project will deprecate certain interfaces that were
        provided as discrete executables by Ruby Gems 0.9.4 and which
        were included in PSARC/2007/600. In RubyGems 1.3.1, the
        functionality provided by many of these executables is now
        implemented in the core RubyGems executable 'gem', other
        functionality now uses standard Ruby tools such as 'ri'.

        An update from RubyGems 0.9.4 to RubyGems 1.3.1 is an absolute
        requirement as Ruby on Rails versions > 2.1.0 require RubyGems
        1.1.1 or greater while Ruby on Rails 2.2.2 specifically
        requires RubyGems 1.3.1

2. Technical Description

        2.1. Details

        This project will mark the deprecated interfaces as obsolete
        and will update all relevant documentation to reflect this
        change. The interfaces themselves will be updated to emit a
        warning to indicate that it's usage has been deprecated and
        detail how similar functionality can be achieved through the
        use of other commands. The changes will also be documented on
        publicly accessible web sites including blogs and project
        pages.

        These changes will follow the guidelines for obsoleting
        interfaces here:
        http://opensolaris.org/os/community/arc/policies/obsolete-eof/

        2.2. Ongoing updates

        Although RubyGems no longer includes these executables (the
        interfaces to be obsoleted) there is still a requirement to
        continue to provide updates to RubyGems in the affected
        packages.  As such, these updates will include scripts of the
        same name as the deprecated executables that wrap the same
        functionality as provided by the gem command and standard Ruby
        tools. These scripts will be removed with the expiry of the
        one year timer that starts after acceptance of this ARC
        case. Additional details of how the functionality of the
        deprecated executable is accessed in the update are available
        in Appendix 1.

        2.3 Changes to Exported Interfaces

        NAME                          STABILITY                 NOTES

        /usr/ruby/[version]/bin
          gem_mirror                  Obsolete Uncommitted      Executable 
	  gem_server                  Obsolete Uncommitted      Executable
          gemlock                     Obsolete Uncommitted      Executable
          gemri                       Obsolete Uncommitted      Executable
          gemwhich                    Obsolete Uncommitted      Executable
          index_gem_repository.rb     Obsolete Uncommitted      Executable
          update_rubygems             Obsolete Uncommitted      Executable

       /usr/bin/
          gem_mirror                  Obsolete Volatile         Symbolic link
          gem_server                  Obsolete Volatile         Symbolic link
          gemlock                     Obsolete Volatile         Symbolic link
          gemri                       Obsolete Volatile         Symbolic link
          gemwhich                    Obsolete Volatile         Symbolic link
          index_gem_repository.rb     Obsolete Volatile         Symbolic link
          update_rubygems             Obsolete Volatile         Symbolic link
          gem_mirror18                Obsolete Volatile         Symbolic link
          gem_server18                Obsolete Volatile         Symbolic link
          gemlock18                   Obsolete Volatile         Symbolic link
          gemri18                     Obsolete Volatile         Symbolic link
          gemwhich18                  Obsolete Volatile         Symbolic link
          index_gem_repository.rb18   Obsolete Volatile         Symbolic link
          update_rubygems18           Obsolete Volatile         Symbolic link


        2.4 Changes to documentation

        The gem[1] man page will be updated to include information on
        how to access the new functionality provided by the 'gem'
        command that replaces that provided by the deprecated
        executables.

        2.5 Packaging and Delivery

        The changes described will be implemented in the update of the
        SUNWruby18[r|u] packages to include RubyGems 1.3.1. There
        should otherwise be no obvious changes to the packaging.


-------------------------------------------------------------------------------
Appendix 1

RubyGems 1.3.1 commands used to provide similar functionality as that
provided by the deprecated executables:

        gem_mirror                gem mirror -v
        gemwhich                  gem which -v
        gemri                     ri --gems --doc-dir
        index_gem_repository.rb   gem generate_index
        gem_server                gem server
        gem_lock                  gem lock
        update_rubygems           gem update --system

6. Resources and Schedule
    6.4. Steering Committee requested information
   	6.4.1. Consolidation C-team Name:
		sfw
    6.5. ARC review type: FastTrack
    6.6. ARC Exposure: open


From John.Fischer@sun.com Tue Jan  6 08:10:31 2009
Received: from sunmail3mpk.sfbay.sun.com (sunmail3mpk.SFBay.Sun.COM [129.146.11.52])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n06GAVVR027936
	for <LSARC-ext@sac.sfbay.sun.com>; Tue, 6 Jan 2009 08:10:31 -0800 (PST)
Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74])
	by sunmail3mpk.sfbay.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id n06GAVlB001397
	for <@sunmail2sca.sfbay.sun.com:LSARC-ext@sun.com>; Tue, 6 Jan 2009 08:10:31 -0800 (PST)
Received: from pmxchannel-daemon.nwk-avmta-1.sfbay.Sun.COM by
 nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0KD20060H4XIPF00@nwk-avmta-1.sfbay.Sun.COM> for LSARC-ext@sun.com
 (ORCPT LSARC-ext@Sun.Com); Tue, 06 Jan 2009 08:10:30 -0800 (PST)
Received: from brmea-mail-2.sun.com ([192.18.98.43])
 by nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KD2003NI4XHP420@nwk-avmta-1.sfbay.Sun.COM> for
 LSARC-ext@sun.com (ORCPT LSARC-ext@Sun.Com); Tue,
 06 Jan 2009 08:10:29 -0800 (PST)
Received: from fe-amer-09.sun.com ([192.18.109.79])
	by brmea-mail-2.sun.com (8.13.6+Sun/8.12.9) with ESMTP id n06GATqE022637	for
 <LSARC-ext@Sun.Com>; Tue, 06 Jan 2009 16:10:29 +0000 (GMT)
Received: from conversion-daemon.mail-amer.sun.com by mail-amer.sun.com
 (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007))
 id <0KD2003014Q6DR00@mail-amer.sun.com>
 (original mail from John.Fischer@Sun.COM)
 for LSARC-ext@Sun.Com (ORCPT LSARC-ext@Sun.Com); Tue,
 06 Jan 2009 09:10:29 -0700 (MST)
Received: from 129.145.154.84 ([129.145.154.84])
 by mail-amer.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28
 2007)) with ESMTPSA id <0KD20037C4XA0PF0@mail-amer.sun.com>; Tue,
 06 Jan 2009 09:10:23 -0700 (MST)
Date: Tue, 06 Jan 2009 08:10:22 -0800
From: John Fischer <John.Fischer@sun.com>
Subject: Re: Ruby Gem Update [LSARC/2009/005 FastTrack timeout 01/13/2009]
In-reply-to: <200901060226.n062QAQ8001912@sac.sfbay.sun.com>
Sender: John.Fischer@sun.com
To: Jyri Virkki <jyri@sac.sfbay.sun.com>
Cc: John Fischer <John.Fischer@sun.com>, LSARC-ext@sun.com,
        Amanda.Waite@sun.com, webstack-discuss@opensolaris.org
Reply-to: John.Fischer@sun.com
Message-id: <1231258221.44944.26.camel@sr1-umpk-34>
MIME-version: 1.0
X-Mailer: Ximian Evolution 1.4.6.301
Content-type: text/plain; charset=ASCII
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
References: <200901060226.n062QAQ8001912@sac.sfbay.sun.com>
Status: RO
Content-Length: 6942

Amanda,

The interface table should include the changed interfaces
within Ruby Gem.  The document appears to indicate that at
the very least gem and ri should be in the Exported Interface
table.  

Is this project requesting a Major, Minor or Patch release
binding of what?  Solaris or something else?

Are we to expect a follow up case to remove the deprecated
interfaces from the WOS?

The following statement:

> 	These scripts will be removed with the expiry of the
>         one year timer that starts after acceptance of this ARC
>         case.

seems to indicate that Ruby Gem is not shipping in a supported
release.  Is that correct?  Or is this saying that it will be
removed in a patch release of the product?  Typically the 
components are removed from the next release that the component
 was included in.  So if a component is deprecated in a Patch 
release of Solaris (i.e., Solaris 10 Updates) then it can be 
removed in a Minor release of Solaris (i.e., Nevada).  Is this
similar?

Thanks,

John

On Mon, 2009-01-05 at 18:26, Jyri Virkki wrote:
> I am sponsoring this case for Amanda Waite for the Web Stack Project.
> Timeout is set to 01/13/2009
> 
> 
> Template Version: @(#)sac_nextcase %I% %G% SMI
> This information is Copyright 2009 Sun Microsystems
> 1. Introduction
>     1.1. Project/Component Working Name:
> 	 Ruby Gem Update
>     1.2. Name of Document Author/Supplier:
> 	 Author:  Amanda Waite
>     1.3  Date of This Document:
> 	05 January, 2009
> 4. Technical Description
> Ruby Gem Update
> Amanda Waite <amanda.waite@sun.com>
> 
> 05 January 2008
> 
> 1. Summary and motivation
> 
>         1.1. Introduction
> 
>         This project will deprecate certain interfaces that were
>         provided as discrete executables by Ruby Gems 0.9.4 and which
>         were included in PSARC/2007/600. In RubyGems 1.3.1, the
>         functionality provided by many of these executables is now
>         implemented in the core RubyGems executable 'gem', other
>         functionality now uses standard Ruby tools such as 'ri'.
> 
>         An update from RubyGems 0.9.4 to RubyGems 1.3.1 is an absolute
>         requirement as Ruby on Rails versions > 2.1.0 require RubyGems
>         1.1.1 or greater while Ruby on Rails 2.2.2 specifically
>         requires RubyGems 1.3.1
> 
> 2. Technical Description
> 
>         2.1. Details
> 
>         This project will mark the deprecated interfaces as obsolete
>         and will update all relevant documentation to reflect this
>         change. The interfaces themselves will be updated to emit a
>         warning to indicate that it's usage has been deprecated and
>         detail how similar functionality can be achieved through the
>         use of other commands. The changes will also be documented on
>         publicly accessible web sites including blogs and project
>         pages.
> 
>         These changes will follow the guidelines for obsoleting
>         interfaces here:
>         http://opensolaris.org/os/community/arc/policies/obsolete-eof/
> 
>         2.2. Ongoing updates
> 
>         Although RubyGems no longer includes these executables (the
>         interfaces to be obsoleted) there is still a requirement to
>         continue to provide updates to RubyGems in the affected
>         packages.  As such, these updates will include scripts of the
>         same name as the deprecated executables that wrap the same
>         functionality as provided by the gem command and standard Ruby
>         tools. These scripts will be removed with the expiry of the
>         one year timer that starts after acceptance of this ARC
>         case. Additional details of how the functionality of the
>         deprecated executable is accessed in the update are available
>         in Appendix 1.
> 
>         2.3 Changes to Exported Interfaces
> 
>         NAME                          STABILITY                 NOTES
> 
>         /usr/ruby/[version]/bin
>           gem_mirror                  Obsolete Uncommitted      Executable 
> 	  gem_server                  Obsolete Uncommitted      Executable
>           gemlock                     Obsolete Uncommitted      Executable
>           gemri                       Obsolete Uncommitted      Executable
>           gemwhich                    Obsolete Uncommitted      Executable
>           index_gem_repository.rb     Obsolete Uncommitted      Executable
>           update_rubygems             Obsolete Uncommitted      Executable
> 
>        /usr/bin/
>           gem_mirror                  Obsolete Volatile         Symbolic link
>           gem_server                  Obsolete Volatile         Symbolic link
>           gemlock                     Obsolete Volatile         Symbolic link
>           gemri                       Obsolete Volatile         Symbolic link
>           gemwhich                    Obsolete Volatile         Symbolic link
>           index_gem_repository.rb     Obsolete Volatile         Symbolic link
>           update_rubygems             Obsolete Volatile         Symbolic link
>           gem_mirror18                Obsolete Volatile         Symbolic link
>           gem_server18                Obsolete Volatile         Symbolic link
>           gemlock18                   Obsolete Volatile         Symbolic link
>           gemri18                     Obsolete Volatile         Symbolic link
>           gemwhich18                  Obsolete Volatile         Symbolic link
>           index_gem_repository.rb18   Obsolete Volatile         Symbolic link
>           update_rubygems18           Obsolete Volatile         Symbolic link
> 
> 
>         2.4 Changes to documentation
> 
>         The gem[1] man page will be updated to include information on
>         how to access the new functionality provided by the 'gem'
>         command that replaces that provided by the deprecated
>         executables.
> 
>         2.5 Packaging and Delivery
> 
>         The changes described will be implemented in the update of the
>         SUNWruby18[r|u] packages to include RubyGems 1.3.1. There
>         should otherwise be no obvious changes to the packaging.
> 
> 
> -------------------------------------------------------------------------------
> Appendix 1
> 
> RubyGems 1.3.1 commands used to provide similar functionality as that
> provided by the deprecated executables:
> 
>         gem_mirror                gem mirror -v
>         gemwhich                  gem which -v
>         gemri                     ri --gems --doc-dir
>         index_gem_repository.rb   gem generate_index
>         gem_server                gem server
>         gem_lock                  gem lock
>         update_rubygems           gem update --system
> 
> 6. Resources and Schedule
>     6.4. Steering Committee requested information
>    	6.4.1. Consolidation C-team Name:
> 		sfw
>     6.5. ARC review type: FastTrack
>     6.6. ARC Exposure: open
> 


From Amanda.Waite@sun.com Tue Jan  6 08:40:08 2009
Received: from sunmail5.uk.sun.com (sunmail5.UK.Sun.COM [129.156.85.165])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n06Ge89n022368
	for <LSARC-ext@sac.sfbay.sun.com>; Tue, 6 Jan 2009 08:40:08 -0800 (PST)
Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74])
	by sunmail5.uk.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id n06Ge4q0025150
	for <@sunmail2sca.sfbay.sun.com:LSARC-ext@sun.com>; Tue, 6 Jan 2009 16:40:06 GMT
Received: from pmxchannel-daemon.nwk-avmta-1.sfbay.Sun.COM by
 nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0KD200A0V6AUKR00@nwk-avmta-1.sfbay.Sun.COM> for LSARC-ext@sun.com
 (ORCPT LSARC-ext@Sun.Com); Tue, 06 Jan 2009 08:40:06 -0800 (PST)
Received: from gmp-eb-inf-2.sun.com ([192.18.6.24])
 by nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KD2003846ASOZ70@nwk-avmta-1.sfbay.Sun.COM> for
 LSARC-ext@sun.com (ORCPT LSARC-ext@Sun.Com); Tue,
 06 Jan 2009 08:40:05 -0800 (PST)
Received: from fe-emea-10.sun.com (gmp-eb-lb-1-fe3.eu.sun.com [192.18.6.10])
	by gmp-eb-inf-2.sun.com (8.13.7+Sun/8.12.9) with ESMTP id n06Ge4e3021229	for
 <LSARC-ext@Sun.Com>; Tue, 06 Jan 2009 16:40:04 +0000 (GMT)
Received: from conversion-daemon.fe-emea-10.sun.com by fe-emea-10.sun.com
 (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007))
 id <0KD2005016253000@fe-emea-10.sun.com>
 (original mail from Amanda.Waite@Sun.COM)
 for LSARC-ext@Sun.Com (ORCPT LSARC-ext@Sun.Com); Tue,
 06 Jan 2009 16:40:04 +0000 (GMT)
Received: from grond.UK.Sun.COM ([129.156.84.184])
 by fe-emea-10.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28
 2007)) with ESMTPSA id <0KD2007PX6AR7H10@fe-emea-10.sun.com> for
 LSARC-ext@Sun.Com (ORCPT LSARC-ext@Sun.Com); Tue,
 06 Jan 2009 16:40:03 +0000 (GMT)
Date: Tue, 06 Jan 2009 16:40:03 +0000
From: Amanda Waite <Amanda.Waite@sun.com>
Subject: Re: Ruby Gem Update [LSARC/2009/005 FastTrack timeout 01/13/2009]
In-reply-to: <1231258221.44944.26.camel@sr1-umpk-34>
Sender: Amanda.Waite@sun.com
To: John.Fischer@sun.com
Cc: LSARC-ext@sun.com, webstack-discuss@opensolaris.org
Message-id: <49638963.3050306@sun.com>
MIME-version: 1.0
Content-type: text/plain; format=flowed; charset=ISO-8859-1
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
References: <200901060226.n062QAQ8001912@sac.sfbay.sun.com>
 <1231258221.44944.26.camel@sr1-umpk-34>
User-Agent: Thunderbird 2.0.0.18 (Macintosh/20081105)
Status: RO
Content-Length: 8373

John,

I'm hoping that the line in the introduction of the case that says:

"This project will deprecate certain interfaces that were provided as 
discrete executables
    by Ruby Gems 0.9.4 and which were included in PSARC/2007/600"

goes some way to answering your questions. This is an update to the Ruby 
packages that were added through
PSARC/2007/600 and which included RubyGems.

John Fischer wrote:
> Amanda,
>
> The interface table should include the changed interfaces
> within Ruby Gem.  The document appears to indicate that at
> the very least gem and ri should be in the Exported Interface
> table.  
>   

You'll find them in PSARC/2007/600. This Case makes no changes to gem 
and ri or any of the other remaining interfaces other than updating them 
to new versions.
> Is this project requesting a Major, Minor or Patch release
> binding of what?  Solaris or something else?
>   

Should I specify this even though we are only obsoleting interfaces that 
were added through another ARC case? PSARC/2007/600 specified a binding 
of micro.

> Are we to expect a follow up case to remove the deprecated
> interfaces from the WOS?
>   

Yes, I'll follow the procedure specified at 
http://opensolaris.org/os/community/arc/policies/obsolete-eof/


> The following statement:
>
>   
>> 	These scripts will be removed with the expiry of the
>>         one year timer that starts after acceptance of this ARC
>>         case.
>>     
>
> seems to indicate that Ruby Gem is not shipping in a supported
> release.  Is that correct?  Or is this saying that it will be
> removed in a patch release of the product?  Typically the 
> components are removed from the next release that the component
>  was included in.  So if a component is deprecated in a Patch 
> release of Solaris (i.e., Solaris 10 Updates) then it can be 
> removed in a Minor release of Solaris (i.e., Nevada).  Is this
> similar?
>   

The Ruby Packages went into the SFW consolidation, are available in 
Nevada and are therefore available in OpenSolaris (and have been since 
2008.05).  So yes they are in a supported release, but we are not sure 
how the ARC process and release bindings apply when it comes to 
OpenSolaris (the micro release binding from the original arc case adds 
to the uncertainty).

Thanks

Amanda

> Thanks,
>
> John
>
> On Mon, 2009-01-05 at 18:26, Jyri Virkki wrote:
>   
>> I am sponsoring this case for Amanda Waite for the Web Stack Project.
>> Timeout is set to 01/13/2009
>>
>>
>> Template Version: @(#)sac_nextcase %I% %G% SMI
>> This information is Copyright 2009 Sun Microsystems
>> 1. Introduction
>>     1.1. Project/Component Working Name:
>> 	 Ruby Gem Update
>>     1.2. Name of Document Author/Supplier:
>> 	 Author:  Amanda Waite
>>     1.3  Date of This Document:
>> 	05 January, 2009
>> 4. Technical Description
>> Ruby Gem Update
>> Amanda Waite <amanda.waite@sun.com>
>>
>> 05 January 2008
>>
>> 1. Summary and motivation
>>
>>         1.1. Introduction
>>
>>         This project will deprecate certain interfaces that were
>>         provided as discrete executables by Ruby Gems 0.9.4 and which
>>         were included in PSARC/2007/600. In RubyGems 1.3.1, the
>>         functionality provided by many of these executables is now
>>         implemented in the core RubyGems executable 'gem', other
>>         functionality now uses standard Ruby tools such as 'ri'.
>>
>>         An update from RubyGems 0.9.4 to RubyGems 1.3.1 is an absolute
>>         requirement as Ruby on Rails versions > 2.1.0 require RubyGems
>>         1.1.1 or greater while Ruby on Rails 2.2.2 specifically
>>         requires RubyGems 1.3.1
>>
>> 2. Technical Description
>>
>>         2.1. Details
>>
>>         This project will mark the deprecated interfaces as obsolete
>>         and will update all relevant documentation to reflect this
>>         change. The interfaces themselves will be updated to emit a
>>         warning to indicate that it's usage has been deprecated and
>>         detail how similar functionality can be achieved through the
>>         use of other commands. The changes will also be documented on
>>         publicly accessible web sites including blogs and project
>>         pages.
>>
>>         These changes will follow the guidelines for obsoleting
>>         interfaces here:
>>         http://opensolaris.org/os/community/arc/policies/obsolete-eof/
>>
>>         2.2. Ongoing updates
>>
>>         Although RubyGems no longer includes these executables (the
>>         interfaces to be obsoleted) there is still a requirement to
>>         continue to provide updates to RubyGems in the affected
>>         packages.  As such, these updates will include scripts of the
>>         same name as the deprecated executables that wrap the same
>>         functionality as provided by the gem command and standard Ruby
>>         tools. These scripts will be removed with the expiry of the
>>         one year timer that starts after acceptance of this ARC
>>         case. Additional details of how the functionality of the
>>         deprecated executable is accessed in the update are available
>>         in Appendix 1.
>>
>>         2.3 Changes to Exported Interfaces
>>
>>         NAME                          STABILITY                 NOTES
>>
>>         /usr/ruby/[version]/bin
>>           gem_mirror                  Obsolete Uncommitted      Executable 
>> 	  gem_server                  Obsolete Uncommitted      Executable
>>           gemlock                     Obsolete Uncommitted      Executable
>>           gemri                       Obsolete Uncommitted      Executable
>>           gemwhich                    Obsolete Uncommitted      Executable
>>           index_gem_repository.rb     Obsolete Uncommitted      Executable
>>           update_rubygems             Obsolete Uncommitted      Executable
>>
>>        /usr/bin/
>>           gem_mirror                  Obsolete Volatile         Symbolic link
>>           gem_server                  Obsolete Volatile         Symbolic link
>>           gemlock                     Obsolete Volatile         Symbolic link
>>           gemri                       Obsolete Volatile         Symbolic link
>>           gemwhich                    Obsolete Volatile         Symbolic link
>>           index_gem_repository.rb     Obsolete Volatile         Symbolic link
>>           update_rubygems             Obsolete Volatile         Symbolic link
>>           gem_mirror18                Obsolete Volatile         Symbolic link
>>           gem_server18                Obsolete Volatile         Symbolic link
>>           gemlock18                   Obsolete Volatile         Symbolic link
>>           gemri18                     Obsolete Volatile         Symbolic link
>>           gemwhich18                  Obsolete Volatile         Symbolic link
>>           index_gem_repository.rb18   Obsolete Volatile         Symbolic link
>>           update_rubygems18           Obsolete Volatile         Symbolic link
>>
>>
>>         2.4 Changes to documentation
>>
>>         The gem[1] man page will be updated to include information on
>>         how to access the new functionality provided by the 'gem'
>>         command that replaces that provided by the deprecated
>>         executables.
>>
>>         2.5 Packaging and Delivery
>>
>>         The changes described will be implemented in the update of the
>>         SUNWruby18[r|u] packages to include RubyGems 1.3.1. There
>>         should otherwise be no obvious changes to the packaging.
>>
>>
>> -------------------------------------------------------------------------------
>> Appendix 1
>>
>> RubyGems 1.3.1 commands used to provide similar functionality as that
>> provided by the deprecated executables:
>>
>>         gem_mirror                gem mirror -v
>>         gemwhich                  gem which -v
>>         gemri                     ri --gems --doc-dir
>>         index_gem_repository.rb   gem generate_index
>>         gem_server                gem server
>>         gem_lock                  gem lock
>>         update_rubygems           gem update --system
>>
>> 6. Resources and Schedule
>>     6.4. Steering Committee requested information
>>    	6.4.1. Consolidation C-team Name:
>> 		sfw
>>     6.5. ARC review type: FastTrack
>>     6.6. ARC Exposure: open
>>
>>     
>
>   


From John.Fischer@sun.com Tue Jan  6 16:58:47 2009
Received: from sunmail5.uk.sun.com (sunmail5.UK.Sun.COM [129.156.85.165])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n070wlga014828
	for <LSARC-ext@sac.sfbay.sun.com>; Tue, 6 Jan 2009 16:58:47 -0800 (PST)
Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11])
	by sunmail5.uk.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id n070wcmn014723
	for <@sunmail2sca.sfbay.sun.com:LSARC-ext@sun.com>; Wed, 7 Jan 2009 00:58:46 GMT
Received: from pmxchannel-daemon.brm-avmta-1.central.sun.com by
 brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0KD200M0RTDX4D00@brm-avmta-1.central.sun.com> for LSARC-ext@sun.com
 (ORCPT LSARC-ext@Sun.Com); Tue, 06 Jan 2009 17:58:45 -0700 (MST)
Received: from brmea-mail-2.sun.com ([192.18.98.43])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KD2006U4TDWQ670@brm-avmta-1.central.sun.com> for
 LSARC-ext@sun.com (ORCPT LSARC-ext@Sun.Com); Tue,
 06 Jan 2009 17:58:44 -0700 (MST)
Received: from fe-amer-10.sun.com ([192.18.109.80])
	by brmea-mail-2.sun.com (8.13.6+Sun/8.12.9) with ESMTP id n070wiM1001262	for
 <LSARC-ext@Sun.Com>; Wed, 07 Jan 2009 00:58:44 +0000 (GMT)
Received: from conversion-daemon.mail-amer.sun.com by mail-amer.sun.com
 (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007))
 id <0KD200M01TAO5300@mail-amer.sun.com>
 (original mail from John.Fischer@Sun.COM)
 for LSARC-ext@Sun.Com (ORCPT LSARC-ext@Sun.Com); Tue,
 06 Jan 2009 17:58:44 -0700 (MST)
Received: from 129.145.154.84 ([129.145.154.84])
 by mail-amer.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28
 2007)) with ESMTPSA id <0KD200GN3TDV0XF0@mail-amer.sun.com> for
 LSARC-ext@Sun.Com (ORCPT LSARC-ext@Sun.Com); Tue,
 06 Jan 2009 17:58:44 -0700 (MST)
Date: Tue, 06 Jan 2009 16:58:43 -0800
From: John Fischer <John.Fischer@sun.com>
Subject: Re: Ruby Gem Update [LSARC/2009/005 FastTrack timeout 01/13/2009]
In-reply-to: <49638963.3050306@sun.com>
Sender: John.Fischer@sun.com
To: Amanda Waite <Amanda.Waite@sun.com>
Cc: John Fischer <John.Fischer@sun.com>, LSARC-ext@sun.com,
        webstack-discuss@opensolaris.org
Reply-to: John.Fischer@sun.com
Message-id: <1231289922.44944.41.camel@sr1-umpk-34>
MIME-version: 1.0
X-Mailer: Ximian Evolution 1.4.6.301
Content-type: text/plain; charset=ASCII
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
References: <200901060226.n062QAQ8001912@sac.sfbay.sun.com>
 <1231258221.44944.26.camel@sr1-umpk-34> <49638963.3050306@sun.com>
Status: RO
Content-Length: 10140

Amanda,

See below.

John

On Tue, 2009-01-06 at 08:40, Amanda Waite wrote:
> John,
> 
> I'm hoping that the line in the introduction of the case that says:
> 
> "This project will deprecate certain interfaces that were provided as 
> discrete executables
>     by Ruby Gems 0.9.4 and which were included in PSARC/2007/600"
> 
> goes some way to answering your questions. This is an update to the Ruby 
> packages that were added through
> PSARC/2007/600 and which included RubyGems.

What the case documentation does is enumerate those changes.
If all the interfaces are changing then all the interfaces
need to be listed.  My group has to do this for each release
of the GNOME stack.  I know it is a pain but it makes the
case complete.

> John Fischer wrote:
> > Amanda,
> >
> > The interface table should include the changed interfaces
> > within Ruby Gem.  The document appears to indicate that at
> > the very least gem and ri should be in the Exported Interface
> > table.  
> >   
> 
> You'll find them in PSARC/2007/600. This Case makes no changes to gem 
> and ri or any of the other remaining interfaces other than updating them 
> to new versions.

Unless these are simple bug fixes then the interface needs to be
listed in the interface tables.

> > Is this project requesting a Major, Minor or Patch release
> > binding of what?  Solaris or something else?
> >   
> 
> Should I specify this even though we are only obsoleting interfaces that 
> were added through another ARC case? PSARC/2007/600 specified a binding 
> of micro.

Since this is only an update to the latest and greatest release
of Ruby Gem then Micro would be fine.  However, when you run the
next case to remove the Obsolete interfaces that must be a Minor
or Major release.

> > Are we to expect a follow up case to remove the deprecated
> > interfaces from the WOS?
> >   
> 
> Yes, I'll follow the procedure specified at 
> http://opensolaris.org/os/community/arc/policies/obsolete-eof/

Great.

> 
> > The following statement:
> >
> >   
> >> 	These scripts will be removed with the expiry of the
> >>         one year timer that starts after acceptance of this ARC
> >>         case.
> >>     
> >
> > seems to indicate that Ruby Gem is not shipping in a supported
> > release.  Is that correct?  Or is this saying that it will be
> > removed in a patch release of the product?  Typically the 
> > components are removed from the next release that the component
> >  was included in.  So if a component is deprecated in a Patch 
> > release of Solaris (i.e., Solaris 10 Updates) then it can be 
> > removed in a Minor release of Solaris (i.e., Nevada).  Is this
> > similar?
> >   
> 
> The Ruby Packages went into the SFW consolidation, are available in 
> Nevada and are therefore available in OpenSolaris (and have been since 
> 2008.05).  So yes they are in a supported release, but we are not sure 
> how the ARC process and release bindings apply when it comes to 
> OpenSolaris (the micro release binding from the original arc case adds 
> to the uncertainty).

So this is a Minor release of Solaris.  What is interesting for 
the committee is the discussion about Open Solaris being a release
and the future case removing the Obsolete interfaces.  That is for
the future case unless this case is also seeking approval for the
removal.  The reason why it is interesting is because it tends to
set a precedent in that the interface was introduced in a Minor
release of Solaris (2008.05 or 2008.11) and then removed in a
Minor release of Solaris (2009.??). This in reality is still the
same Micro release of Solaris which is a slight change in the
Obsolete rules.  Again, unless this case is also seeking the
approval to remove we can hold off on that discussion.  

> Thanks
> 
> Amanda
> 
> > Thanks,
> >
> > John
> >
> > On Mon, 2009-01-05 at 18:26, Jyri Virkki wrote:
> >   
> >> I am sponsoring this case for Amanda Waite for the Web Stack Project.
> >> Timeout is set to 01/13/2009
> >>
> >>
> >> Template Version: @(#)sac_nextcase %I% %G% SMI
> >> This information is Copyright 2009 Sun Microsystems
> >> 1. Introduction
> >>     1.1. Project/Component Working Name:
> >> 	 Ruby Gem Update
> >>     1.2. Name of Document Author/Supplier:
> >> 	 Author:  Amanda Waite
> >>     1.3  Date of This Document:
> >> 	05 January, 2009
> >> 4. Technical Description
> >> Ruby Gem Update
> >> Amanda Waite <amanda.waite@sun.com>
> >>
> >> 05 January 2008
> >>
> >> 1. Summary and motivation
> >>
> >>         1.1. Introduction
> >>
> >>         This project will deprecate certain interfaces that were
> >>         provided as discrete executables by Ruby Gems 0.9.4 and which
> >>         were included in PSARC/2007/600. In RubyGems 1.3.1, the
> >>         functionality provided by many of these executables is now
> >>         implemented in the core RubyGems executable 'gem', other
> >>         functionality now uses standard Ruby tools such as 'ri'.
> >>
> >>         An update from RubyGems 0.9.4 to RubyGems 1.3.1 is an absolute
> >>         requirement as Ruby on Rails versions > 2.1.0 require RubyGems
> >>         1.1.1 or greater while Ruby on Rails 2.2.2 specifically
> >>         requires RubyGems 1.3.1
> >>
> >> 2. Technical Description
> >>
> >>         2.1. Details
> >>
> >>         This project will mark the deprecated interfaces as obsolete
> >>         and will update all relevant documentation to reflect this
> >>         change. The interfaces themselves will be updated to emit a
> >>         warning to indicate that it's usage has been deprecated and
> >>         detail how similar functionality can be achieved through the
> >>         use of other commands. The changes will also be documented on
> >>         publicly accessible web sites including blogs and project
> >>         pages.
> >>
> >>         These changes will follow the guidelines for obsoleting
> >>         interfaces here:
> >>         http://opensolaris.org/os/community/arc/policies/obsolete-eof/
> >>
> >>         2.2. Ongoing updates
> >>
> >>         Although RubyGems no longer includes these executables (the
> >>         interfaces to be obsoleted) there is still a requirement to
> >>         continue to provide updates to RubyGems in the affected
> >>         packages.  As such, these updates will include scripts of the
> >>         same name as the deprecated executables that wrap the same
> >>         functionality as provided by the gem command and standard Ruby
> >>         tools. These scripts will be removed with the expiry of the
> >>         one year timer that starts after acceptance of this ARC
> >>         case. Additional details of how the functionality of the
> >>         deprecated executable is accessed in the update are available
> >>         in Appendix 1.
> >>
> >>         2.3 Changes to Exported Interfaces
> >>
> >>         NAME                          STABILITY                 NOTES
> >>
> >>         /usr/ruby/[version]/bin
> >>           gem_mirror                  Obsolete Uncommitted      Executable 
> >> 	  gem_server                  Obsolete Uncommitted      Executable
> >>           gemlock                     Obsolete Uncommitted      Executable
> >>           gemri                       Obsolete Uncommitted      Executable
> >>           gemwhich                    Obsolete Uncommitted      Executable
> >>           index_gem_repository.rb     Obsolete Uncommitted      Executable
> >>           update_rubygems             Obsolete Uncommitted      Executable
> >>
> >>        /usr/bin/
> >>           gem_mirror                  Obsolete Volatile         Symbolic link
> >>           gem_server                  Obsolete Volatile         Symbolic link
> >>           gemlock                     Obsolete Volatile         Symbolic link
> >>           gemri                       Obsolete Volatile         Symbolic link
> >>           gemwhich                    Obsolete Volatile         Symbolic link
> >>           index_gem_repository.rb     Obsolete Volatile         Symbolic link
> >>           update_rubygems             Obsolete Volatile         Symbolic link
> >>           gem_mirror18                Obsolete Volatile         Symbolic link
> >>           gem_server18                Obsolete Volatile         Symbolic link
> >>           gemlock18                   Obsolete Volatile         Symbolic link
> >>           gemri18                     Obsolete Volatile         Symbolic link
> >>           gemwhich18                  Obsolete Volatile         Symbolic link
> >>           index_gem_repository.rb18   Obsolete Volatile         Symbolic link
> >>           update_rubygems18           Obsolete Volatile         Symbolic link
> >>
> >>
> >>         2.4 Changes to documentation
> >>
> >>         The gem[1] man page will be updated to include information on
> >>         how to access the new functionality provided by the 'gem'
> >>         command that replaces that provided by the deprecated
> >>         executables.
> >>
> >>         2.5 Packaging and Delivery
> >>
> >>         The changes described will be implemented in the update of the
> >>         SUNWruby18[r|u] packages to include RubyGems 1.3.1. There
> >>         should otherwise be no obvious changes to the packaging.
> >>
> >>
> >> -------------------------------------------------------------------------------
> >> Appendix 1
> >>
> >> RubyGems 1.3.1 commands used to provide similar functionality as that
> >> provided by the deprecated executables:
> >>
> >>         gem_mirror                gem mirror -v
> >>         gemwhich                  gem which -v
> >>         gemri                     ri --gems --doc-dir
> >>         index_gem_repository.rb   gem generate_index
> >>         gem_server                gem server
> >>         gem_lock                  gem lock
> >>         update_rubygems           gem update --system
> >>
> >> 6. Resources and Schedule
> >>     6.4. Steering Committee requested information
> >>    	6.4.1. Consolidation C-team Name:
> >> 		sfw
> >>     6.5. ARC review type: FastTrack
> >>     6.6. ARC Exposure: open
> >>
> >>     
> >
> >   
> 


From Jyri.Virkki@sun.com Tue Jan  6 17:03:01 2009
Received: from sunmail5.uk.sun.com (sunmail5.UK.Sun.COM [129.156.85.165])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n07130F6014939
	for <LSARC-ext@sac.sfbay.sun.com>; Tue, 6 Jan 2009 17:03:00 -0800 (PST)
Received: from brm-avmta-1.central.sun.com (brm-avmta-1.Central.Sun.COM [129.147.4.11])
	by sunmail5.uk.sun.com (8.13.8+Sun/8.13.8/ENSMAIL,v2.2) with ESMTP id n0712xRp017300;
	Wed, 7 Jan 2009 01:02:59 GMT
Received: from pmxchannel-daemon.brm-avmta-1.central.sun.com by
 brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0KD200M01TKYIB00@brm-avmta-1.central.sun.com>; Tue,
 06 Jan 2009 18:02:58 -0700 (MST)
Received: from brmea-mail-1.sun.com ([192.18.98.31])
 by brm-avmta-1.central.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KD2006F3TKYPV90@brm-avmta-1.central.sun.com>; Tue,
 06 Jan 2009 18:02:58 -0700 (MST)
Received: from dm-usca15-11.red.iplanet.com
 (host-185-56-18-192.iplanet.com [192.18.56.185] (may be forged))
	by brmea-mail-1.sun.com (8.13.6+Sun/8.12.9) with ESMTP id n0712vXd005404; Wed,
 07 Jan 2009 01:02:57 +0000 (GMT)
Received: from buye.red.iplanet.com (buye [192.18.65.224])
	by dm-usca15-11.red.iplanet.com (8.11.7p1+Sun/8.11.7/IPLANET,v1.2)
 with ESMTP id n0712um16877; Tue, 06 Jan 2009 17:02:56 -0800 (PST)
Received: from buye.red.iplanet.com (localhost [127.0.0.1])
	by buye.red.iplanet.com (8.13.7+Sun/8.13.7) with ESMTP id n0712uHR015106; Tue,
 06 Jan 2009 17:02:56 -0800 (PST)
Received: (from jyri@localhost)
	by buye.red.iplanet.com (8.13.7+Sun/8.13.7/Submit) id n0712uLX015105; Tue,
 06 Jan 2009 17:02:56 -0800 (PST)
Date: Tue, 06 Jan 2009 17:02:56 -0800
From: Jyri Virkki <Jyri.Virkki@sun.com>
Subject: Re: Ruby Gem Update [LSARC/2009/005 FastTrack timeout 01/13/2009]
In-reply-to: <49638963.3050306@sun.com>
To: Amanda Waite <Amanda.Waite@sun.com>
Cc: LSARC-ext@sun.com, webstack-discuss@opensolaris.org
Message-id: <20090107010256.GG10299@sun.com>
MIME-version: 1.0
Content-type: text/plain; charset=us-ascii
Content-transfer-encoding: 7BIT
Content-disposition: inline
X-PMX-Version: 5.4.1.325704
References: <200901060226.n062QAQ8001912@sac.sfbay.sun.com>
 <1231258221.44944.26.camel@sr1-umpk-34> <49638963.3050306@sun.com>
User-Agent: Mutt/1.5.11
Status: RO
Content-Length: 1042

Amanda Waite wrote:
>
> The Ruby Packages went into the SFW consolidation, are available in 
> Nevada and are therefore available in OpenSolaris (and have been since 
> 2008.05).  So yes they are in a supported release, but we are not sure 
> how the ARC process and release bindings apply when it comes to 
> OpenSolaris (the micro release binding from the original arc case adds 
> to the uncertainty).

The problem is that the current releases are OpenSolaris but we ARC
don't know how those map to the release taxonomy.  Was 2008.11 a major
or minor or micro or patch release for these purposes? What will
2009.N be? I don't know.

While that is A Problem, it's far broader than this case so it's not
this case.

Amanda I suggest marking this case for a micro/patch release for
consistency with previous one (although there is no intention to
backport to S10 since ruby itself isn't). Note this case is just the
obsoletion announcement, actual removal being some future case.


-- 
Jyri J. Virkki - jyri.virkki@sun.com - Sun Microsystems

From Amanda.Waite@sun.com Thu Jan  8 11:04:33 2009
Received: from newsunmail1brm.central.sun.com (newsunmail1brm.Central.Sun.COM [129.147.62.245])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n08J4X6m005956
	for <LSARC-ext@sac.sfbay.sun.com>; Thu, 8 Jan 2009 11:04:33 -0800 (PST)
Received: from nwk-avmta-1.SFBay.Sun.COM (nwk-avmta-1.SFBay.Sun.COM [129.146.11.74])
	by newsunmail1brm.central.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id n08J4TfW005946
	for <@sunmail2sca.sfbay.sun.com:LSARC-ext@sun.com>; Thu, 8 Jan 2009 12:04:33 -0700 (MST)
Received: from pmxchannel-daemon.nwk-avmta-1.sfbay.Sun.COM by
 nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0KD600K072BIY100@nwk-avmta-1.sfbay.Sun.COM> for LSARC-ext@sun.com
 (ORCPT LSARC-ext@Sun.Com); Thu, 08 Jan 2009 11:04:30 -0800 (PST)
Received: from gmp-eb-inf-2.sun.com ([192.18.6.24])
 by nwk-avmta-1.sfbay.Sun.COM
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KD600LEM2BHNAF0@nwk-avmta-1.sfbay.Sun.COM> for
 LSARC-ext@sun.com (ORCPT LSARC-ext@Sun.Com); Thu,
 08 Jan 2009 11:04:30 -0800 (PST)
Received: from fe-emea-09.sun.com (gmp-eb-lb-2-fe2.eu.sun.com [192.18.6.11])
	by gmp-eb-inf-2.sun.com (8.13.7+Sun/8.12.9) with ESMTP id n08J4TTl028483	for
 <LSARC-ext@Sun.Com>; Thu, 08 Jan 2009 19:04:29 +0000 (GMT)
Received: from conversion-daemon.fe-emea-09.sun.com by fe-emea-09.sun.com
 (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007))
 id <0KD600M0129JL200@fe-emea-09.sun.com>
 (original mail from Amanda.Waite@Sun.COM)
 for LSARC-ext@Sun.Com (ORCPT LSARC-ext@Sun.Com); Thu,
 08 Jan 2009 19:04:28 +0000 (GMT)
Received: from grond.UK.Sun.COM ([129.156.84.184])
 by fe-emea-09.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28
 2007)) with ESMTPSA id <0KD600K9W2BGOS10@fe-emea-09.sun.com> for
 LSARC-ext@Sun.Com (ORCPT LSARC-ext@Sun.Com); Thu,
 08 Jan 2009 19:04:28 +0000 (GMT)
Date: Thu, 08 Jan 2009 19:04:26 +0000
From: Amanda Waite <Amanda.Waite@sun.com>
Subject: Re: [webstack-discuss] Ruby Gem Update [LSARC/2009/005 FastTrack
 timeout 01/13/2009]
In-reply-to: <1231289922.44944.41.camel@sr1-umpk-34>
Sender: Amanda.Waite@sun.com
To: John.Fischer@sun.com
Cc: webstack-discuss@opensolaris.org, LSARC-ext@sun.com
Message-id: <49664E3A.4000407@sun.com>
MIME-version: 1.0
Content-type: text/plain; format=flowed; charset=ISO-8859-1
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
References: <200901060226.n062QAQ8001912@sac.sfbay.sun.com>
 <1231258221.44944.26.camel@sr1-umpk-34> <49638963.3050306@sun.com>
 <1231289922.44944.41.camel@sr1-umpk-34>
User-Agent: Thunderbird 2.0.0.19 (Macintosh/20081209)
Status: RO
Content-Length: 6055

Hi John,

Thanks for pointing me in the right direction on this.

I've added the request for micro release binding and I've added the 
'gem' command to the list of changed interfaces. Using the Ruby 'ri' 
command in place of gemri has been possible since before the original 
Arc case and before the integration into Nevada so 'ri' hasn't changed 
in this update.  I've mentioned this in section 2.4.

Jyri is on vacation but has updated the Arc case on the sac system. I've 
include it here.

Thanks

Amanda


Ruby Gem Update
Amanda Waite <amanda.waite@sun.com>

07 January 2008

1. Summary and motivation

        1.1. Introduction

        This project will deprecate certain interfaces that were
        provided as discrete executables by Ruby Gems 0.9.4 and which
        were included in PSARC/2007/600. In RubyGems 1.3.1, the
        functionality provided by many of these executables is now
        implemented in the core RubyGems executable 'gem', other
        functionality now uses standard Ruby tools such as 'ri'.

        An update from RubyGems 0.9.4 to RubyGems 1.3.1 is an absolute
        requirement as Ruby on Rails versions > 2.1.0 require RubyGems
        1.1.1 or greater while Ruby on Rails 2.2.2 specifically
        requires RubyGems 1.3.1

        This case seeks micro release binding.

2. Technical Description

        2.1. Details

        This project will mark the deprecated interfaces as obsolete
        and will update all relevant documentation to reflect this
        change. The interfaces themselves will be updated to emit a
        warning to indicate that it's usage has been deprecated and
        detail how similar functionality can be achieved through the
        use of other commands. The changes will also be documented on
        publicly accessible web sites including blogs and project
        pages.

        These changes will follow the guidelines for obsoleting
        interfaces here:
        http://opensolaris.org/os/community/arc/policies/obsolete-eof/

        2.2. Ongoing updates

        Although RubyGems no longer includes these executables (the
        interfaces to be obsoleted) there is still a requirement to
        continue to provide updates to RubyGems in the affected
        packages.  As such, these updates will include scripts of the
        same name as the deprecated executables that wrap the same
        functionality as provided by the gem command and standard Ruby
        tools. These scripts will be removed with the expiry of the
        one year timer that starts after acceptance of this ARC
        case. Additional details of how the functionality of the
        deprecated executable is accessed in the update are available
        in Appendix 1.

        2.3 Updated Interfaces

        The 'gem' command has been updated to add support for some of the
        functionality that was provided by the deprecated executables.
     
        The Ruby 'ri' command has not changed in this update, the
        functionality originally provided by 'gemri' comes from command
        line options that are already available in Ruby 'ri'.

        2.4 Changes to Exported Interfaces

        NAME                          STABILITY                 NOTES

        /usr/ruby/[version]/bin
          gem                         Uncommitted               Executable

          gem_mirror                  Obsolete Uncommitted      Executable
          gem_server                  Obsolete Uncommitted      Executable
          gemlock                     Obsolete Uncommitted      Executable
          gemri                       Obsolete Uncommitted      Executable
          gemwhich                    Obsolete Uncommitted      Executable
          index_gem_repository.rb     Obsolete Uncommitted      Executable
          update_rubygems             Obsolete Uncommitted      Executable

        /usr/bin/
          gem_mirror                  Obsolete Volatile         Symbolic 
link
          gem_server                  Obsolete Volatile         Symbolic 
link
          gemlock                     Obsolete Volatile         Symbolic 
link
          gemri                       Obsolete Volatile         Symbolic 
link
          gemwhich                    Obsolete Volatile         Symbolic 
link
          index_gem_repository.rb     Obsolete Volatile         Symbolic 
link
          update_rubygems             Obsolete Volatile         Symbolic 
link

          gem_mirror18                Obsolete Volatile         Symbolic 
link
          gem_server18                Obsolete Volatile         Symbolic 
link
          gemlock18                   Obsolete Volatile         Symbolic 
link
          gemri18                     Obsolete Volatile         Symbolic 
link
          gemwhich18                  Obsolete Volatile         Symbolic 
link
          index_gem_repository.rb18   Obsolete Volatile         Symbolic 
link
          update_rubygems18           Obsolete Volatile         Symbolic 
link

        2.5 Changes to documentation

        The gem[1] man page will be updated to include information on
        how to access the new functionality provided by the 'gem'
        command that replaces that provided by the deprecated
        executables.

        2.6 Packaging and Delivery

        The changes described will be implemented in the update of the
        SUNWruby18[r|u] packages to include RubyGems 1.3.1. There
        should otherwise be no obvious changes to the packaging.


-------------------------------------------------------------------------------
Appendix 1

RubyGems 1.3.1 commands used to provide similar functionality as that
provided by the deprecated executables:

        gem_mirror                gem mirror -v
        gemwhich                  gem which -v
        gemri                     ri --gems --doc-dir
        index_gem_repository.rb   gem generate_index
        gem_server                gem server
        gem_lock                  gem lock
        update_rubygems           gem update --system


From Jyri.Virkki@sun.com Tue Jan 13 10:18:57 2009
Received: from sunmail2sca.sfbay.sun.com (sunmail2sca.SFBay.Sun.COM [129.145.155.234])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n0DIIvjL016860
	for <LSARC-ext@sac.sfbay.sun.com>; Tue, 13 Jan 2009 10:18:57 -0800 (PST)
Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6])
	by sunmail2sca.sfbay.sun.com (8.13.7+Sun/8.13.7/ENSMAIL,v2.2) with ESMTP id n0DIIsb1020400;
	Tue, 13 Jan 2009 10:18:56 -0800 (PST)
Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by
 nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0KDF00L1R9JIY700@nwk-avmta-2.sfbay.sun.com>; Tue,
 13 Jan 2009 10:18:54 -0800 (PST)
Received: from brmea-mail-4.sun.com ([192.18.98.36])
 by nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KDF00FAI9JIBSB0@nwk-avmta-2.sfbay.sun.com>; Tue,
 13 Jan 2009 10:18:54 -0800 (PST)
Received: from dm-usca19-13.red.iplanet.com
 (host-179-56-18-192.iplanet.com [192.18.56.179] (may be forged))
	by brmea-mail-4.sun.com (8.13.6+Sun/8.12.9) with ESMTP id n0DIIoW6007109; Tue,
 13 Jan 2009 18:18:51 +0000 (GMT)
Received: from buye.red.iplanet.com (buye [192.18.65.224])
	by dm-usca19-13.red.iplanet.com (8.11.7p1+Sun/8.11.7/IPLANET,v1.2)
 with ESMTP id n0DIIos13756; Tue, 13 Jan 2009 10:18:50 -0800 (PST)
Received: from buye.red.iplanet.com (localhost [127.0.0.1])
	by buye.red.iplanet.com (8.13.7+Sun/8.13.7) with ESMTP id n0DIIocY004837; Tue,
 13 Jan 2009 10:18:50 -0800 (PST)
Received: (from jyri@localhost)
	by buye.red.iplanet.com (8.13.7+Sun/8.13.7/Submit) id n0DIIoVU004836; Tue,
 13 Jan 2009 10:18:50 -0800 (PST)
Date: Tue, 13 Jan 2009 10:18:50 -0800
From: Jyri Virkki <Jyri.Virkki@sun.com>
Subject: Re: [webstack-discuss] Ruby Gem Update [LSARC/2009/005 FastTrack
 timeout 01/13/2009]
In-reply-to: <49664E3A.4000407@sun.com>
To: Amanda Waite <Amanda.Waite@sun.com>
Cc: webstack-discuss@opensolaris.org, LSARC-ext@sun.com
Message-id: <20090113181850.GA4832@sun.com>
MIME-version: 1.0
Content-type: text/plain; charset=us-ascii
Content-transfer-encoding: 7BIT
Content-disposition: inline
X-PMX-Version: 5.4.1.325704
References: <200901060226.n062QAQ8001912@sac.sfbay.sun.com>
 <1231258221.44944.26.camel@sr1-umpk-34> <49638963.3050306@sun.com>
 <1231289922.44944.41.camel@sr1-umpk-34> <49664E3A.4000407@sun.com>
User-Agent: Mutt/1.5.11
Status: RO
Content-Length: 136


> Ruby Gem Update

This case was closed approved at LSARC meeting today.


-- 
Jyri J. Virkki - jyri.virkki@sun.com - Sun Microsystems

From Amanda.Waite@sun.com Tue Jan 13 10:33:27 2009
Received: from sunmail4.singapore.sun.com (sunmail4.Singapore.Sun.COM [129.158.71.19])
	by sac.sfbay.sun.com (8.13.8+Sun/8.13.8) with ESMTP id n0DIXQ8C018044
	for <LSARC-ext@sac.sfbay.sun.com>; Tue, 13 Jan 2009 10:33:27 -0800 (PST)
Received: from nwk-avmta-2.sfbay.sun.com (nwk-avmta-2.SFBay.Sun.COM [129.145.155.6])
	by sunmail4.singapore.sun.com (8.13.4+Sun/8.13.3/ENSMAIL,v2.2) with ESMTP id n0DIXKkW014505
	for <@sunmail2sca.sfbay.sun.com:LSARC-ext@sun.com>; Wed, 14 Jan 2009 02:33:25 +0800 (SGT)
Received: from pmxchannel-daemon.nwk-avmta-2.sfbay.sun.com by
 nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 id <0KDF00M0FA7PNP00@nwk-avmta-2.sfbay.sun.com> for LSARC-ext@sun.com
 (ORCPT LSARC-ext@sun.com); Tue, 13 Jan 2009 10:33:25 -0800 (PST)
Received: from gmp-eb-inf-2.sun.com ([192.18.6.24])
 by nwk-avmta-2.sfbay.sun.com
 (Sun Java System Messaging Server 6.2-3.04 (built Jul 15 2005))
 with ESMTP id <0KDF00F2LA7IBUB0@nwk-avmta-2.sfbay.sun.com> for
 LSARC-ext@sun.com (ORCPT LSARC-ext@sun.com); Tue,
 13 Jan 2009 10:33:23 -0800 (PST)
Received: from fe-emea-10.sun.com (gmp-eb-lb-2-fe3.eu.sun.com [192.18.6.12])
	by gmp-eb-inf-2.sun.com (8.13.7+Sun/8.12.9) with ESMTP id n0DIXHat018858	for
 <LSARC-ext@sun.com>; Tue, 13 Jan 2009 18:33:17 +0000 (GMT)
Received: from conversion-daemon.fe-emea-10.sun.com by fe-emea-10.sun.com
 (Sun Java System Messaging Server 6.2-8.04 (built Feb 28 2007))
 id <0KDF00L01A4A0P00@fe-emea-10.sun.com>
 (original mail from Amanda.Waite@Sun.COM)
 for LSARC-ext@sun.com (ORCPT LSARC-ext@sun.com); Tue,
 13 Jan 2009 18:33:17 +0000 (GMT)
Received: from grond.UK.Sun.COM ([129.156.84.184])
 by fe-emea-10.sun.com (Sun Java System Messaging Server 6.2-8.04 (built Feb 28
 2007)) with ESMTPSA id <0KDF00GOMA7GPKA0@fe-emea-10.sun.com> for
 LSARC-ext@sun.com (ORCPT LSARC-ext@sun.com); Tue,
 13 Jan 2009 18:33:16 +0000 (GMT)
Date: Tue, 13 Jan 2009 18:33:13 +0000
From: Amanda Waite <Amanda.Waite@sun.com>
Subject: Re: [webstack-discuss] Ruby Gem Update [LSARC/2009/005 FastTrack
 timeout 01/13/2009]
In-reply-to: <20090113181850.GA4832@sun.com>
Sender: Amanda.Waite@sun.com
To: Jyri Virkki <Jyri.Virkki@sun.com>
Cc: webstack-discuss@opensolaris.org, LSARC-ext@sun.com
Message-id: <496CDE69.10405@sun.com>
MIME-version: 1.0
Content-type: text/plain; format=flowed; charset=ISO-8859-1
Content-transfer-encoding: 7BIT
X-PMX-Version: 5.4.1.325704
References: <200901060226.n062QAQ8001912@sac.sfbay.sun.com>
 <1231258221.44944.26.camel@sr1-umpk-34> <49638963.3050306@sun.com>
 <1231289922.44944.41.camel@sr1-umpk-34> <49664E3A.4000407@sun.com>
 <20090113181850.GA4832@sun.com>
User-Agent: Thunderbird 2.0.0.19 (Macintosh/20081209)
Status: RO
Content-Length: 128

Thanks Jyri.

Jyri Virkki wrote:
>> Ruby Gem Update
>>     
>
> This case was closed approved at LSARC meeting today.
>
>
>   


