Bug 665536

Summary:	man rpmbuild does not mention --define
Product:	[Fedora] Fedora	Reporter:	Eric Blake <eblake>
Component:	rpm	Assignee:	Panu Matilainen <pmatilai>
Status:	CLOSED RAWHIDE	QA Contact:	Fedora Extras Quality Assurance <extras-qa>
Severity:	medium	Docs Contact:
Priority:	low
Version:	17	CC:	eblake, ffesti, jnovy, pmatilai
Target Milestone:	---	Keywords:	Reopened
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2012-11-19 13:01:29 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 Eric Blake 2010-12-24 14:54:08 UTC

Description of problem:
The man page for rpmbuild is incomplete.

Version-Release number of selected component (if applicable):
rpm-build-4.8.1-5.fc14.x86_64

How reproducible:
100%

Steps to Reproduce:
1. rpmbuild --help | grep define
2. man rpmbuild | grep define

  
Actual results:
1.   -D, --define='MACRO EXPR'     define MACRO with value EXPR
2. (nothing)

Expected results:
the man page should list every possible option to rpmbuild, including -D/--define (there may be other missing options, I didn't do a full audit).

Additional info:

Comment 1 Fedora End Of Life 2012-08-16 19:51:06 UTC

This message is a notice that Fedora 14 is now at end of life. Fedora 
has stopped maintaining and issuing updates for Fedora 14. It is 
Fedora's policy to close all bug reports from releases that are no 
longer maintained.  At this time, all open bugs with a Fedora 'version'
of '14' have been closed as WONTFIX.

(Please note: Our normal process is to give advanced warning of this 
occurring, but we forgot to do that. A thousand apologies.)

Package Maintainer: If you wish for this bug to remain open because you
plan to fix it in a currently maintained version, feel free to reopen 
this bug and simply change the 'version' to a later Fedora version.

Bug Reporter: Thank you for reporting this issue and we are sorry that 
we were unable to fix it before Fedora 14 reached end of life. If you 
would still like to see this bug fixed and are able to reproduce it 
against a later version of Fedora, you are encouraged to click on 
"Clone This Bug" (top right of this page) and open it against that 
version of Fedora.

Although we aim to fix as many bugs as possible during every release's 
lifetime, sometimes those efforts are overtaken by events.  Often a 
more recent Fedora release includes newer upstream software that fixes 
bugs or makes them obsolete.

The process we are following is described here: 
http://fedoraproject.org/wiki/BugZappers/HouseKeeping

Comment 2 Eric Blake 2012-08-16 19:53:13 UTC

Reopening - F17 still has this bug.

Comment 3 Panu Matilainen 2012-11-19 13:01:29 UTC

"Fixed" in rpm >= 4.11, not worth tracking for f17 separately: --define is listed under "Common options for all rpm modes and executables" section in 'rpmbuild --help' output and if you follow the "SEE ALSO" section in rpmbuild manual you'll find the documentation in 'man rpm', so its not exactly an entirely undocumented thing.