Bug 616414

Summary:	yum's man page should indicate that localinstall and localupdate commands exist only for legacy reasons
Product:	[Fedora] Fedora	Reporter:	Andre Robatino <robatino>
Component:	yum	Assignee:	Seth Vidal <skvidal>
Status:	CLOSED UPSTREAM	QA Contact:	Fedora Extras Quality Assurance <extras-qa>
Severity:	medium	Docs Contact:
Priority:	low
Version:	rawhide	CC:	ffesti, james.antill, kparal, maxamillion, pmatilai, tim.lauridsen
Target Milestone:	---	Keywords:	Reopened
Target Release:	---
Hardware:	All
OS:	Linux
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2010-07-20 13:26:08 UTC	Type:	---
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description Andre Robatino 2010-07-20 12:04:49 UTC

Description of problem:
Yum has "localinstall" and "localupdate" commands, but no "localdowngrade" command.  This means that if one wants to switch between older and newer versions of a package, the update can be done locally with yum, but a local downgrade requires direct use of the rpm command.  This means either wasting bandwidth, or using rpm directly.  If the new version of the package breaks networking, using rpm is unavoidable.

Version-Release number of selected component (if applicable):
yum-3.2.27-18.fc14.noarch

Comment 1 seth vidal 2010-07-20 12:12:56 UTC

the downgrade command itself should handle this w/o an issue. just run:

yum downgrade /path/to/some/file.rpm

Comment 2 Andre Robatino 2010-07-20 12:39:54 UTC

Thanks, that's good to know, but why is the syntax different from that for install and update?

Comment 3 seth vidal 2010-07-20 13:05:40 UTC

It is not different. install and update can both take an option of a .rpm filename just as well as anything else.

localinstall/localupdate were added before we merged the functionality into install/update. They've been kept around purely for legacy reasons so we don't break people's scripts.

-sv

Comment 4 Andre Robatino 2010-07-20 13:19:34 UTC

Ok, that makes sense.  The man page is still confusing in that the descriptions of localinstall and localupdate don't mention at all that they currently exist purely for legacy reasons, so people (like me) tend to think we still have to use it for local operations.  Reopening and changing the Summary accordingly.

Comment 5 seth vidal 2010-07-20 13:26:08 UTC

fixed upstream.

Comment 6 seth vidal 2010-07-26 14:49:53 UTC

*** Bug 618154 has been marked as a duplicate of this bug. ***

Comment 7 Kamil Páral 2010-07-26 15:53:10 UTC

In this case I recommend to leave those commands in man page (with obsoletion remark), but remove them from --help and from bash completion. So new users won't start using them. (I don't know what the actual change in upstream was, but this would seem reasonable for me.)

Comment 8 Andre Robatino 2010-07-27 15:09:38 UTC

This bug is fixed in the latest yum-3.2.27-20.fc14.noarch, but Kamil's bug still isn't, so I suggested in that bug that it be reopened (but it should be quick to fix since it only involves removing "localinstall" from --help).