Bug 540634

Summary: no devel docs in libvorbis-devel-docs
Product: [Fedora] Fedora Reporter: Edward Sheldrake <ejsheldrake>
Component: libvorbisAssignee: Adam Jackson <ajax>
Status: CLOSED RAWHIDE QA Contact: Fedora Extras Quality Assurance <extras-qa>
Severity: low Docs Contact:
Priority: low    
Version: rawhideCC: ajax, hdegoede, jnovy
Target Milestone: ---Keywords: Reopened
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: libvorbis-1.2.3-4.fc12 Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2012-01-04 12:12:35 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:
Attachments:
Description Flags
libvorbis.spec doc fix none

Description Edward Sheldrake 2009-11-23 20:36:27 UTC 
Description of problem:
Absence of developer documentation in libvorbis-devel-docs.

Version-Release number of selected component (if applicable):
libvorbis-devel-docs-1.2.3-3.fc12

How reproducible:
Always.

Steps to Reproduce:
1. rpm -ql libvorbis-devel-docs
2.
3.
  
Actual results:
It only contains AUTHORS, COPYING and README.

Expected results:
It should contain some devel docs, mainly the API reference in HTML format.

Additional info:
They don't end up packaged because they get installed to the same directory the main package %doc puts its file, and %doc deletes that directory first.
Comment 1 Fedora Update System 2009-11-23 22:43:10 UTC 
libvorbis-1.2.3-4.fc12 has been submitted as an update for Fedora 12.
http://admin.fedoraproject.org/updates/libvorbis-1.2.3-4.fc12
Comment 2 Fedora Update System 2009-11-25 15:13:05 UTC 
libvorbis-1.2.3-4.fc12 has been pushed to the Fedora 12 testing repository.  If problems still persist, please make note of it in this bug report.
 If you want to test the update, you can install it with 
 su -c 'yum --enablerepo=updates-testing update libvorbis'.  You can provide feedback for this update here: http://admin.fedoraproject.org/updates/F12/FEDORA-2009-12112
Comment 3 Fedora Update System 2010-02-27 03:48:56 UTC 
libvorbis-1.2.3-4.fc12 has been pushed to the Fedora 12 stable repository.  If problems still persist, please make note of it in this bug report.
Comment 4 Edward Sheldrake 2010-11-02 07:52:32 UTC 
This needs re-fixing for Fedora 14. This works for the COPYING file:

%doc %{_docdir}/%{name}-%{version}/COPYING
Comment 5 Jindrich Novy 2012-01-04 07:54:34 UTC 
F14 has reached its end of life. All seems to be fine in f15 and on. Please reopen if not.
Comment 6 Edward Sheldrake 2012-01-04 09:47:20 UTC 
The most recent libvorbis build is 1.3.2-1.fc15 which just contains the COPYING file in -devel-docs.

However, if libvorbis is rebuilt on F-16 with rpm 4.9.1, due to bug #728959 you get all the html API docs present in both libvorbis and libvorbis-devel-docs, wasting disk space (for people who weren't going to install them).
Comment 7 Edward Sheldrake 2012-01-04 09:48:42 UTC 
Created attachment 550641 [details]
libvorbis.spec doc fix
Comment 8 Jindrich Novy 2012-01-04 12:12:35 UTC 
Ok, there is a file conflict in your solution as COPYING is shipped by both libvorbis and libvorbis-devel-doc. It doesn't matter much as RPM ignores documentation conflicts. I excluded COPYING from libvorbis-devel-doc to avoid it.

I'm not sure whether this change is worth f16 update. In any case it is now fixed in rawhide.