Bug 616414 - yum's man page should indicate that localinstall and localupdate commands exist only for legacy reasons
Summary: yum's man page should indicate that localinstall and localupdate commands exi...
Keywords:
Status: CLOSED UPSTREAM
Alias: None
Product: Fedora
Classification: Fedora
Component: yum
Version: rawhide
Hardware: All
OS: Linux
low
medium
Target Milestone: ---
Assignee: Seth Vidal
QA Contact: Fedora Extras Quality Assurance
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2010-07-20 12:04 UTC by Andre Robatino
Modified: 2014-01-21 23:16 UTC (History)
6 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2010-07-20 13:26:08 UTC
Type: ---
Embargoed:


Attachments (Terms of Use)

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


Note You need to log in before you can comment on or make changes to this bug.