X-Recipient: archive-cygwin AT delorie DOT com
X-SWARE-Spam-Status: No, hits=-5.8 required=5.0	tests=AWL,BAYES_00,RCVD_IN_DNSWL_HI,RP_MATCHES_RCVD
X-Spam-Check-By: sourceware.org
X-IronPortListener: Outbound_SMTP
X-IronPort-Anti-Spam-Filtered: true
X-IronPort-Anti-Spam-Result: AtwAAAXTtk6cKEcV/2dsb2JhbABDmhuOVIEggQWBcgEBAQQSKE8CAQgNJwIQHxMlAQEEARoah2iZGJo7iEhjBIgLhCqNPIw6
From: "Buchbinder, Barry (NIH/NIAID) [E]" <BBuchbinder AT niaid DOT nih DOT gov>
To: "cygwin AT cygwin DOT com" <cygwin AT cygwin DOT com>,
        "'Oleksandr Gavenko'"	<gavenkoa AT gmail DOT com>
Date: Sun, 6 Nov 2011 13:37:50 -0500
Subject: RE: What does mean 'obsolete' category?
Message-ID: <0105D5C1E0353146B1B222348B0411A20A39C92BB5@NIHMLBX02.nih.gov>
References: <87lirujg4q DOT fsf AT gmail DOT com>
In-Reply-To: <87lirujg4q.fsf@gmail.com>
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
X-IsSubscribed: yes
Mailing-List: contact cygwin-help AT cygwin DOT com; run by ezmlm
List-Id: <cygwin.cygwin.com>
List-Subscribe: <mailto:cygwin-subscribe AT cygwin DOT com>
List-Archive: <http://sourceware.org/ml/cygwin/>
List-Post: <mailto:cygwin AT cygwin DOT com>
List-Help: <mailto:cygwin-help AT cygwin DOT com>, <http://sourceware.org/ml/#faqs>
Sender: cygwin-owner AT cygwin DOT com
Mail-Followup-To: cygwin AT cygwin DOT com
Delivered-To: mailing list cygwin AT cygwin DOT com
Content-Transfer-Encoding: 8bit
X-MIME-Autoconverted: from quoted-printable to 8bit by delorie.com id pA6IcBL8005929

Oleksandr Gavenko sent the following at Saturday, November 05, 2011 7:37 PM
>Search:
>  http://cygwin.com/cgi-bin2/package-grep.cgi?grep=xorg-x11-xwin
>
>take:
>  xorg-x11-xwin/xorg-x11-xwin-7.4-1  Obsolete package
>
>From setup.ini:
>  @ xorg-x11-xwin
>  sdesc: "Obsolete package"
>  ldesc: "Obsolete package"
>  category: _obsolete
>
>That mean 'obsolete' for package?
>
>I search for docs in:
>  Cygwin Package Contributor's Guide
>  Cygwin User's Guide
>  http://sourceware.org/cygwin-apps/setup-head.ini.html
>
>but does not found any relevant docs for 'obsolete' keyword.
>
>Do this mean that package deprecated and I need avoid its uses?
>
>Or it is for a long time does not updated and can have known bugs?
>
>I will be glad if docs updated with appropriate texts.

They are how obsolete packages are removed and replaced by their successors.

Lets look at the setup.ini entry for ash.

@ ash
sdesc: "Replaced by dash"
ldesc: "OBSOLETE PKG: replaced by dash"
category: _obsolete
requires: dash cygwin
version: 20040127-5
install: release/ash/ash-20040127-5.tar.bz2 46 c616cffee0f344c37fd4e045a7a87054
source: release/ash/ash-20040127-5-src.tar.bz2 46 c616cffee0f344c37fd4e045a7a87054
[prev]
version: 20040127-4
install: release/ash/ash-20040127-4.tar.bz2 47178 26b04e64b710f4e9592258446920a992
source: release/ash/ash-20040127-4-src.tar.bz2 140516 7fa68e8ed663ac77b484079aab026ed8

Note that both the install and source tarballs are effectively empty - only 46 bytes.

When setup updates, it first removes the previous version, here ash-20040127-4.tar.bz2,
before trying to install the non-existent contents of ash-20040127-5.tar.bz2.  The
requires line then tells setup to install dash, the replacement of ash.

I could be wrong about this, but it seems to me that one other thing that "_obsolete"
does is to move the directory of the package in setup.exe's local package cache to be
a subdirectory of .../release/_obsolete/.

So the category _obsolete means "do not install this" and "you cannot use this
because it is not here", which is a bit stronger than "deprecated" and "avoid".

I hope that helps.  (I also hope that that was correct.  :-) )

- Barry
	Disclaimer:  Statements made herein are not made on behalf of NIAID.


--
Problem reports:       http://cygwin.com/problems.html
FAQ:                   http://cygwin.com/faq/
Documentation:         http://cygwin.com/docs.html
Unsubscribe info:      http://cygwin.com/ml/#unsubscribe-simple