Bug 998149

Summary: Duplicated documentation
Product: [Fedora] Fedora Reporter: Michael Schwendt <bugs.michael>
Component: jsoncppAssignee: Sébastien Willmann <sebastien.willmann>
Status: CLOSED ERRATA QA Contact: Fedora Extras Quality Assurance <extras-qa>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 20CC: sebastien.willmann
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: jsoncpp-0.6.0-0.11.rc2.fc20 Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2013-09-26 06:25:12 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:
Embargoed:
Bug Depends On:    
Bug Blocks: 993551    
Attachments:
Description Flags
one way to fix it none

Description Michael Schwendt 2013-08-17 18:24:45 UTC 
For the Fedora 20 unversioned docdirs change,

  https://fedoraproject.org/wiki/Changes/UnversionedDocdirs

the jsoncpp package will need a fix, as currently it duplicates the documentation from the -doc subpackage in the base package. This is because %doc now picks up files stored in %{_docdir}/%{name}.

> %files doc
> %doc AUTHORS LICENSE NEWS.txt README.txt
> %{_docdir}/%{name}
Comment 1 Michael Schwendt 2013-08-17 21:43:22 UTC 
The duplicated doc files currently also cause a conflict on e.g. i686, because the noarch -doc package may have been built on a different arch.
Comment 2 Sébastien Willmann 2013-09-08 17:14:26 UTC 
How should I fix this? Exclude the directory from the main package? Install doc in another directory?
Comment 3 Michael Schwendt 2013-09-08 18:22:59 UTC 
Created attachment 795387 [details]
one way to fix it

There are multiple solutions. Attached is one that also removes the extra /usr/share/doc/jsoncpp-doc directory in the -doc package. And it puts the many files from the doxygen docs into a html folder. Else it gets very crowded in the top docdir.


General discussion of this problem:
https://fedorahosted.org/fpc/ticket/338

Further information:
http://fedoraproject.org/wiki/Changes/UnversionedDocdirs
https://fedoraproject.org/wiki/Packaging_tricks#Installing_documentation:_2_paths
Comment 4 Sébastien Willmann 2013-09-10 20:16:03 UTC 
Thanks, I'm applying the suggested patch.
Comment 5 Fedora Update System 2013-09-10 20:18:04 UTC 
jsoncpp-0.6.0-0.11.rc2.fc20 has been submitted as an update for Fedora 20.
https://admin.fedoraproject.org/updates/jsoncpp-0.6.0-0.11.rc2.fc20
Comment 6 Fedora Update System 2013-09-11 16:59:16 UTC 
Package jsoncpp-0.6.0-0.11.rc2.fc20:
* should fix your issue,
* was pushed to the Fedora 20 testing repository,
* should be available at your local mirror within two days.
Update it with:
# su -c 'yum update --enablerepo=updates-testing jsoncpp-0.6.0-0.11.rc2.fc20'
as soon as you are able to.
Please go to the following url:
https://admin.fedoraproject.org/updates/FEDORA-2013-16433/jsoncpp-0.6.0-0.11.rc2.fc20
then log in and leave karma (feedback).
Comment 7 Fedora End Of Life 2013-09-16 17:12:31 UTC 
This bug appears to have been reported against 'rawhide' during the Fedora 20 development cycle.
Changing version to '20'.

More information and reason for this action is here:
https://fedoraproject.org/wiki/BugZappers/HouseKeeping/Fedora20
Comment 8 Fedora Update System 2013-09-26 06:25:12 UTC 
jsoncpp-0.6.0-0.11.rc2.fc20 has been pushed to the Fedora 20 stable repository.  If problems still persist, please make note of it in this bug report.