Bug 82213

Summary:	Please remove version number from %doc path.
Product:	[Retired] Red Hat Linux	Reporter:	Han-Wen Nienhuys <hanwen>
Component:	rpm-build	Assignee:	Jeff Johnson <jbj>
Status:	CLOSED NOTABUG	QA Contact:
Severity:	medium	Docs Contact:
Priority:	low
Version:	8.0
Target Milestone:	---
Target Release:	---
Hardware:	All
OS:	Linux
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2003-01-20 15:01:43 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 Han-Wen Nienhuys 2003-01-19 23:49:25 UTC

Description of problem:

tagging files with %doc puts them into /usr/share/doc/<package>-<version>
I want to ask if <version> can be removed from the directory name: 

since it is not (or should not) be possible to install multiple versions of the
same package alongside each other, <version> does not serve a purpose.

The <version> does make it a lot harder to refer to standardized file locations
 for packages. If <version> were not present, it would be possible to write the
following in a webpage:

  After installing package foo, you will find installed doco by clicking
  <a href=file:///usr/share/doc/foo/index.html>here</a>

The version number makes this rather painful.

If there is a reason for this, then  I would appreciate this being documented. 
I have searched in vain for it (actually: a manual with packaging policies for
RedHat would be much appreciated, MaximumRPM and the HOWTO don't cut it: they're
too low on details.)

Thanks.

Han-Wen Nienhuys

Comment 1 Jeff Johnson 2003-01-20 15:01:43 UTC

Look at %docdir.