Bug 204177

Summary: Review Request: digikam-doc - digiKam and Showfoto documentation
Product: [Fedora] Fedora Reporter: Marcin Garski <mgarski>
Component: Package ReviewAssignee: Rex Dieter <rdieter>
Status: CLOSED NEXTRELEASE QA Contact: Fedora Package Reviews List <fedora-package-review>
Severity: medium Docs Contact:
Priority: medium    
Version: rawhideCC: panemade
Target Milestone: ---Flags: kevin: fedora-cvs+
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2006-09-02 19:42:26 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:
Bug Depends On:    
Bug Blocks: 163779    
Attachments:
Description Flags
fix for noarch build
none
specfile patch for items in comment #9 none

Description Marcin Garski 2006-08-26 13:08:49 UTC
Spec URL: http://dakar.lunixsys.com/~mgarski/digikam-doc.spec
SRPM URL: http://dakar.lunixsys.com/~mgarski/digikam-doc-0.8.2-1.src.rpm
Description: Documentation for the digiKam and Showfoto.

Comment 1 Parag AN(पराग) 2006-08-31 13:36:35 UTC
packaging looks ok.
+ Mockbuild is successfull for i386 FC6
- rpmlint on binary rpm is NOT silent
W: digikam-doc summary-not-capitalized digiKam and Showfoto documentation
Summary doesn't begin with a capital letter.

=>Make Summary start with capital letter

E: digikam-doc no-binary
The package should be of the noarch architecture because it doesn't contain
any binaries.

=>make package noarch type 

W: digikam-doc dangling-relative-symlink /usr/share/doc/HTML/pt/digikam/common
../common
The relative symbolic link points nowhere.

W: digikam-doc dangling-relative-symlink /usr/share/doc/HTML/nl/showfoto/common
../common
The relative symbolic link points nowhere.

W: digikam-doc dangling-relative-symlink /usr/share/doc/HTML/et/digikam/common
../common
The relative symbolic link points nowhere.

W: digikam-doc dangling-relative-symlink /usr/share/doc/HTML/de/digikam/common
../common
The relative symbolic link points nowhere.

W: digikam-doc dangling-relative-symlink /usr/share/doc/HTML/da/digikam/common
../common
The relative symbolic link points nowhere.

W: digikam-doc dangling-relative-symlink /usr/share/doc/HTML/de/showfoto/common
../common
The relative symbolic link points nowhere.

W: digikam-doc dangling-relative-symlink /usr/share/doc/HTML/da/showfoto/common
../common
The relative symbolic link points nowhere.

W: digikam-doc dangling-relative-symlink /usr/share/doc/HTML/pl/digikam/common
../common
The relative symbolic link points nowhere.

W: digikam-doc dangling-relative-symlink
/usr/share/doc/HTML/pt_BR/digikam/common ../common
The relative symbolic link points nowhere.

W: digikam-doc dangling-relative-symlink /usr/share/doc/HTML/es/showfoto/common
../common
The relative symbolic link points nowhere.

W: digikam-doc dangling-relative-symlink /usr/share/doc/HTML/sv/digikam/common
../common
The relative symbolic link points nowhere.

W: digikam-doc dangling-relative-symlink /usr/share/doc/HTML/en/digikam/common
../common
The relative symbolic link points nowhere.

W: digikam-doc dangling-relative-symlink /usr/share/doc/HTML/nl/digikam/common
../common
The relative symbolic link points nowhere.

W: digikam-doc dangling-relative-symlink /usr/share/doc/HTML/es/digikam/common
../common
The relative symbolic link points nowhere.

W: digikam-doc dangling-relative-symlink /usr/share/doc/HTML/pl/showfoto/common
../common
The relative symbolic link points nowhere.

W: digikam-doc dangling-relative-symlink /usr/share/doc/HTML/pt/showfoto/common
../common
The relative symbolic link points nowhere.

W: digikam-doc dangling-relative-symlink /usr/share/doc/HTML/fr/showfoto/common
../common
The relative symbolic link points nowhere.

W: digikam-doc dangling-relative-symlink /usr/share/doc/HTML/et/showfoto/common
../common
The relative symbolic link points nowhere.

W: digikam-doc dangling-relative-symlink /usr/share/doc/HTML/it/showfoto/common
../common
The relative symbolic link points nowhere.

W: digikam-doc dangling-relative-symlink /usr/share/doc/HTML/en/showfoto/common
../common
The relative symbolic link points nowhere.

W: digikam-doc dangling-relative-symlink /usr/share/doc/HTML/sv/showfoto/common
../common
The relative symbolic link points nowhere.

W: digikam-doc dangling-relative-symlink /usr/share/doc/HTML/it/digikam/common
../common
The relative symbolic link points nowhere
=> check link path where you want to link in SPEC file

+ dist tag is present
+ Buildroot is correct
+ source URL is correct
+ BR is correct
+ License used is GPL
+ License file COPYING is included
+ Desktop file is handled correctly
+ MD5 sum on tarball is matching upstream tarball
5fea0b1d1aff7ce98954bbc3951d5fa9  digikam-doc-0.8.2-r1.tar.bz2
+ No duplicate files

why files from this package is not merged with digikam package?


Comment 2 Rex Dieter 2006-08-31 15:39:38 UTC
I can review this.

Comment 3 Marcin Garski 2006-08-31 16:22:01 UTC
(In reply to comment #1)
> =>Make Summary start with capital letter

digiKam is the proper name of the project, with capital letter it's invalid.

> =>make package noarch type 

Adding 'BuildArch: noarch' cause this error:
checking build system type... x86_64-redhat-linux-gnu
checking host system type... x86_64-redhat-linux-gnu
checking target system type... Invalid configuration `noarch-redhat-linux-gnu':
machine `noarch-redhat' not recognized
configure: error: /bin/sh admin/config.sub noarch-redhat-linux-gnu failed

> => check link path where you want to link in SPEC file

Links point to ../common directory which is provided by i.e by kdelibs (required
by digikam package, digikam package is needed by digikam-doc)

> + License used is GPL

License is GFDL

> why files from this package is not merged with digikam package?

This is how it's made in upstream, why? Probably because it's 40MB of docs
against 4.2M of apps, so rebuilding digikam package (with docs included) cause
almost 36MB bandwidth wasting.

Comment 4 Paul Howarth 2006-08-31 16:33:33 UTC
(In reply to comment #3)
> (In reply to comment #1)
> > =>Make Summary start with capital letter
> 
> digiKam is the proper name of the project, with capital letter it's invalid.

Perhaps a compromise would be to change the summary to:

Documentation for digiKam and Showfoto

> > =>make package noarch type 
> 
> Adding 'BuildArch: noarch' cause this error:
> checking build system type... x86_64-redhat-linux-gnu
> checking host system type... x86_64-redhat-linux-gnu
> checking target system type... Invalid configuration `noarch-redhat-linux-gnu':
> machine `noarch-redhat' not recognized
> configure: error: /bin/sh admin/config.sub noarch-redhat-linux-gnu failed

This is probably due to someone copy-and-pasting configure.ac bits between
projects. What happens if you have a noarch package and you use:

%configure --target=sparc64

Does that fix the problem?

Comment 5 Marcin Garski 2006-08-31 19:35:58 UTC
(In reply to comment #4)
> Perhaps a compromise would be to change the summary to:
> 
> Documentation for digiKam and Showfoto

Oh, you are right :) thanks.

> > checking target system type... Invalid configuration `noarch-redhat-linux-gnu':
> > machine `noarch-redhat' not recognized
> > configure: error: /bin/sh admin/config.sub noarch-redhat-linux-gnu failed
> 
> This is probably due to someone copy-and-pasting configure.ac bits between
> projects. What happens if you have a noarch package and you use:
> 
> %configure --target=sparc64
> 
> Does that fix the problem?

"checking target system type... sparc64-unknown-none" and building goes fine,
above error is caused by %configure macro which set
"--target=noarch-redhat-linux-gnu".

Comment 6 Paul Howarth 2006-08-31 19:42:23 UTC
(In reply to comment #5)
> > > checking target system type... Invalid configuration
`noarch-redhat-linux-gnu':
> > > machine `noarch-redhat' not recognized
> > > configure: error: /bin/sh admin/config.sub noarch-redhat-linux-gnu failed
> > 
> > This is probably due to someone copy-and-pasting configure.ac bits between
> > projects. What happens if you have a noarch package and you use:
> > 
> > %configure --target=sparc64
> > 
> > Does that fix the problem?
> 
> "checking target system type... sparc64-unknown-none" and building goes fine,
> above error is caused by %configure macro which set
> "--target=noarch-redhat-linux-gnu".

This isn't normally a problem unless there is for some reason AC_CANONICAL_* in
the configure.ac, so that the configure script can make platform-specific
decisions. Is that the case here, and if so, what is platform-dependent? I'd
have thought nothing was platform dependent for a documentation package.


Comment 7 Marcin Garski 2006-08-31 19:59:47 UTC
There isn't anything platform-dependent in documentation package, I've just
tried to fix this in clean way, becuse IMHO "--target=" is more like a
workaround. Anyway thanks for help, I've added "--target=x86" :)

Spec URL: http://dakar.lunixsys.com/~mgarski/digikam-doc.spec
SRPM URL: http://dakar.lunixsys.com/~mgarski/digikam-doc-0.8.2-2.src.rpm

- Changed summary field
- Build as noarch

Comment 8 Paul Howarth 2006-08-31 20:09:49 UTC
(In reply to comment #7)
> There isn't anything platform-dependent in documentation package, I've just
> tried to fix this in clean way, becuse IMHO "--target=" is more like a
> workaround. Anyway thanks for help, I've added "--target=x86" :)

This is still a workaround; "--target=x86" certainly isn't true for a ppc build
for instance. The proper fix would be to patch out the configure check for the
platform. I'm not saying that you need to do that though, since the workaround
gets the package building as noarch successfully.


Comment 9 Rex Dieter 2006-08-31 20:10:42 UTC
1.  MUST: --target=x86 will break on the buildsystem, as will may try to build
.noarch on a ppc builder.  (I'll attach a patch soon for that)

2.  marking files under %_docdir as %doc is redundant (everything under %_docdir
is already implicitly %doc).

Comment 10 Rex Dieter 2006-08-31 20:12:23 UTC
Created attachment 135326 [details]
fix for noarch build

Comment 11 Rex Dieter 2006-08-31 20:14:13 UTC
Created attachment 135327 [details]
specfile patch for items in comment #9

Comment 12 Rex Dieter 2006-08-31 20:22:08 UTC
Alternatively, or could avoid the need for patch + automake by changing
--target=x86
to
--target=%{_build_cpu}

Not sure which, patching, or using --target is better (less hackish)

Comment 13 Rex Dieter 2006-08-31 20:23:28 UTC
If it wasn't clear from comment #12, I'll leave it up to you to decide which
approach you'd rather take in maintaining this (as a noarch build).

Comment 14 Marcin Garski 2006-08-31 20:48:31 UTC
Spec URL: http://dakar.lunixsys.com/~mgarski/digikam-doc.spec
SRPM URL: http://dakar.lunixsys.com/~mgarski/digikam-doc-0.8.2-3.src.rpm

- Remove redundant %doc
- Fix noarch building

I have used --target=%{_build_cpu}, and will report this issue upstream.

Comment 15 Rex Dieter 2006-08-31 20:52:07 UTC
Looks good, thanks, APPROVED. 

BTW, you interested in doing digikamimageplugins-doc too?  (:

Comment 16 Marcin Garski 2006-08-31 21:25:54 UTC
Thanks for approving. I will import package when CVS will be up (recently it had
many downtimes).

I will consider making digikamimageplugins-doc, but IMHO you as a
digikamimageplugins maintainer could keep base and doc package in better sync :)

Comment 17 Rex Dieter 2006-09-01 02:52:19 UTC
OK, ok, I'll go whip something up.

Comment 18 Rex Dieter 2006-09-01 02:55:14 UTC
And, many thanks Paul for the hint on the auto* magic to make the .noarch build
work.

Comment 19 Rex Dieter 2006-09-01 17:46:48 UTC
FYI, digikamimageplugins-doc bug #204955

Marcin or Paul, maybe one of you would be interested in reviewing? :)

Comment 20 Marcin Garski 2006-09-02 19:42:26 UTC
I'm not official reviewer and I didn't review any package, so I'll have to dig
through documentation and see how things are working, then I could review your
package :)

Comment 21 Rex Dieter 2007-12-10 20:13:15 UTC
Package Change Request
======================
Package Name: digikam-doc
New Branches: EL-5

Comment 22 Kevin Fenzi 2007-12-10 20:19:51 UTC
cvs done.