Bug 1015421

Summary:	rpm --help nor man rpm mentions --import option
Product:	[Fedora] Fedora	Reporter:	Jiri Pospisil <pojir>
Component:	rpm	Assignee:	Packaging Maintenance Team <packaging-team-maint>
Status:	CLOSED NOTABUG	QA Contact:	Fedora Extras Quality Assurance <extras-qa>
Severity:	unspecified	Docs Contact:
Priority:	unspecified
Version:	19	CC:	ffesti, jzeleny, novyjindrich, packaging-team-maint, pknirsch, pmatilai
Target Milestone:	---
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2013-10-04 12:21:33 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:

Description Jiri Pospisil 2013-10-04 08:13:31 UTC

Description of problem:
I just found out, that widely used option "--import" of the rpm binary isn't mentioned anywhere in 'rpm --help' nor 'man rpm'. If I understand it correctly, rpm uses the binary 'rpmkeys' for such operation. This option is mentioned in both help and man of rpmkeys. I think it would be advisable to include it even in help and man of rpm itself.

Version-Release number of selected component (if applicable):
rpm-4.11.1-3.fc19.x86_64

How reproducible:
always

Steps to Reproduce:
1. rpm --help | grep -e "--import"
2. man rpm | grep -e "--import"

Actual results:
nothing found

Expected results:
"--import" is documented

Comment 1 Panu Matilainen 2013-10-04 12:21:33 UTC

As you noticed, --import is documented where the functionality is: rpmkeys --help and manual. 'rpm --import', along with numerous other similar things (rpmdb- and signing operations etc) are nothing but backwards-compatibility glue to avoid breaking every related script in the world. The use of these "hidden" backwards-compatibility switches is deprecated and that's one of the reasons they're only documented in the "new" places.