Bug 577152 - Review Request: apiextractor - Library headers parser to extract API information
Summary: Review Request: apiextractor - Library headers parser to extract API information
Keywords:
Status: CLOSED ERRATA
Alias: None
Product: Fedora
Classification: Fedora
Component: Package Review
Version: rawhide
Hardware: All
OS: Linux
medium
medium
Target Milestone: ---
Assignee: Jonathan Steffan
QA Contact: Fedora Extras Quality Assurance
URL:
Whiteboard:
Depends On:
Blocks: 604695
TreeView+ depends on / blocked
 
Reported: 2010-03-26 11:01 UTC by Kalev Lember
Modified: 2019-01-09 12:33 UTC (History)
6 users (show)

Fixed In Version: apiextractor-0.6.0-4.fc13
Clone Of:
Environment:
Last Closed: 2010-06-29 15:38:18 UTC
Type: ---
Embargoed:
jonathansteffan: fedora-review+
gwync: fedora-cvs+


Attachments (Terms of Use)

Description Kalev Lember 2010-03-26 11:01:45 UTC
Spec URL: http://kalev.fedorapeople.org/apiextractor.spec
SRPM URL: http://kalev.fedorapeople.org/apiextractor-0.4.0-1.fc14.src.rpm
Description:
The API Extractor library is used by the binding generator to parse headers of
a given library and merge this data with information provided by typesystem
(XML) files, resulting in a representation of how the API should be exported
to the chosen target language. The generation of source code for the bindings
is performed by specific generators using the API Extractor library.

Koji scratch build: http://koji.fedoraproject.org/koji/taskinfo?taskID=2076874

Comment 1 Chen Lei 2010-03-26 17:29:55 UTC
Hi Kalev,


Would you be interested in packaging the whole pyside set?
BTW, %{_libdir}/cmake/ApiExtractor-%{version}/ seems not the right place for cmake modules.

Comment 2 Kalev Lember 2010-03-26 19:36:27 UTC
(In reply to comment #1)
> Would you be interested in packaging the whole pyside set?

Yes, that's my plan. Would you be interested in reviewing the whole set?


> BTW, %{_libdir}/cmake/ApiExtractor-%{version}/ seems not the right place for
> cmake modules.    

This is the place where cmake-aware projects put their arch-specific configuration [1] (the files may contain references to %{_libdir}, for example). The directory %{_libdir}/cmake/ is roughly similar to %{_libdir}/pkgconfig/ -- both are placed under %{_libdir} for the same reason. Several KDE packages install files in this directory and Fedora cmake package recently started owning the directory [2].

[1] http://www.cmake.org/Wiki/CMake_2.6_Notes#Packages
[2] http://cvs.fedoraproject.org/viewvc/rpms/cmake/devel/cmake.spec?r1=1.76&r2=1.77

Comment 3 Chen Lei 2010-03-27 11:41:34 UTC
(In reply to comment #2)
> (In reply to comment #1)
> > Would you be interested in packaging the whole pyside set?
> Yes, that's my plan. Would you be interested in reviewing the whole set?
> > BTW, %{_libdir}/cmake/ApiExtractor-%{version}/ seems not the right place for
> > cmake modules.    
> This is the place where cmake-aware projects put their arch-specific
> configuration [1] (the files may contain references to %{_libdir}, for
> example). The directory %{_libdir}/cmake/ is roughly similar to
> %{_libdir}/pkgconfig/ -- both are placed under %{_libdir} for the same reason.
> Several KDE packages install files in this directory and Fedora cmake package
> recently started owning the directory [2].
> [1] http://www.cmake.org/Wiki/CMake_2.6_Notes#Packages
> [2]
> http://cvs.fedoraproject.org/viewvc/rpms/cmake/devel/cmake.spec?r1=1.76&r2=1.77    

Thanks for clarification. currently fedora doesn't have a packaging guideline according to cmake modules(even a draft), so I'm a little confusion about this, historically cmake package didn't own {_libdir}/cmake and some packages store cmake modules on %{_datadir}/cmake/%{name} (e.g. boost 1.41).

Comment 4 Kalev Lember 2010-03-27 12:03:08 UTC
(In reply to comment #3)
> Thanks for clarification. currently fedora doesn't have a packaging guideline
> according to cmake modules(even a draft), so I'm a little confusion about this,
> historically cmake package didn't own {_libdir}/cmake and some packages store
> cmake modules on %{_datadir}/cmake/%{name} (e.g. boost 1.41).    

Right, cmake searches in both %{_datadir}/cmake/ and %{_libdir}/cmake/ (and some more places), it's just that you can't put arch-specific configuration in %{_datadir}.

Just for reference I looked up what packages install in these directories.

Packages which install cmake modules in %{_datadir}/cmake/:
shared-desktop-ontologies-devel
boost-devel

Packages which install cmake modules in %{_libdir}/cmake/:
kdepimlibs-devel
kdevplatform-devel
kdebase-workspace-devel
akonadi-devel

Comment 5 Chen Lei 2010-03-28 12:05:56 UTC
(In reply to comment #2)
> (In reply to comment #1)
> > Would you be interested in packaging the whole pyside set?
> Yes, that's my plan. Would you be interested in reviewing the whole set?

I'd like to review pyside set several weeks later after I finish package reviews that were assigned to me already.

Comment 7 Jonathan Steffan 2010-06-19 22:54:49 UTC
apiextractor.src: W: spelling-error %description -l en_US typesystem -> type system, type-system, typesetter
apiextractor.x86_64: W: spelling-error %description -l en_US typesystem -> type system, type-system, typesetter
apiextractor-devel.x86_64: W: no-documentation
4 packages and 0 specfiles checked; 0 errors, 3 warnings.

MUST: rpmlint must be run on every package. The output should be posted in the review.

Please update spec to include the spelling fixes. The no-documentation warning is something that should be addressed. Maybe ship the "doc" folder in the -devel subpackage as %doc ?

Comment 8 Kalev Lember 2010-06-19 23:18:47 UTC
* Sun Jun 20 2010 Kalev Lember <kalev> - 0.6.0-2
- Build html documentation and ship it in -devel subpackage
- typo fix in description

Spec URL: http://kalev.fedorapeople.org/apiextractor.spec
SRPM URL: http://kalev.fedorapeople.org/apiextractor-0.6.0-2.fc14.src.rpm

Scratch build:
http://koji.fedoraproject.org/koji/taskinfo?taskID=2259495

Comment 9 Jonathan Steffan 2010-06-19 23:25:39 UTC
apiextractor-devel.x86_64: W: hidden-file-or-dir /usr/share/doc/apiextractor-devel-0.6.0/html/.buildinfo
4 packages and 0 specfiles checked; 0 errors, 1 warnings.

Please remove this directory.

Comment 10 Kalev Lember 2010-06-19 23:33:54 UTC
* Sun Jun 20 2010 Kalev Lember <kalev> - 0.6.0-3
- Removed .buildinfo file from documentation directory

Spec URL: http://kalev.fedorapeople.org/apiextractor.spec
SRPM URL: http://kalev.fedorapeople.org/apiextractor-0.6.0-3.fc14.src.rpm

Comment 11 Jonathan Steffan 2010-06-19 23:44:04 UTC
4 packages and 0 specfiles checked; 0 errors, 0 warnings.

Looks good. Passes all MUSTS and all SHOULDS.

Comment 12 Kalev Lember 2010-06-20 00:12:13 UTC
Thank you for the review, Jonathan!

New Package CVS Request
=======================
Package Name: apiextractor
Short Description: Library headers parser to extract API information
Owners: kalev
Branches: F-13
InitialCC:

Comment 13 Chen Lei 2010-06-20 02:15:39 UTC
Some suggestions:

Group for apoextractor should be Group:          System Environment/Libraries, Development/Libraries is for -devel only.

Also, some rpm warnings can be ignored, e.g.  spelling-error, it's Okay.

I noticed apiextractor rpm for opensuse patched the place of cmake modules from %{_libdir}/cmake/ApiExtractor-%{version}/ to %{_libdir}/cmake/ApiExtractor, I' not sure if it's needed.

Comment 14 Kalev Lember 2010-06-20 10:26:38 UTC
(In reply to comment #13)
> Group for apoextractor should be Group:          System Environment/Libraries,
> Development/Libraries is for -devel only.

I'll change that, thanks.

By the way, do you know of any Fedora guidelines for choosing RPM groups? I guess there are none, since RPM groups are pretty much obsoleted by comps.


> I noticed apiextractor rpm for opensuse patched the place of cmake modules from
> %{_libdir}/cmake/ApiExtractor-%{version}/ to %{_libdir}/cmake/ApiExtractor, I'
> not sure if it's needed.    

No idea why they would want to do that. CMake searches both directories for module configuration files, so there is really no advantage using one over other.

Do you have a link to that opensuse package?

Comment 15 Kalev Lember 2010-06-20 11:01:29 UTC
Updated owners list.

New Package CVS Request
=======================
Package Name: apiextractor
Short Description: Library headers parser to extract API information
Owners: kalev rdieter kkofler than ltinkl
Branches: F-13
InitialCC:

Comment 16 Chen Lei 2010-06-20 11:46:07 UTC
(In reply to comment #14)
> (In reply to comment #13)
> > Group for apoextractor should be Group:          System Environment/Libraries,
> > Development/Libraries is for -devel only.
> I'll change that, thanks.
> By the way, do you know of any Fedora guidelines for choosing RPM groups? I
> guess there are none, since RPM groups are pretty much obsoleted by comps.
NO guideline as I known, but comps can not replace rpm group because most libraries are not registerd in comps.

> > I noticed apiextractor rpm for opensuse patched the place of cmake modules from
> > %{_libdir}/cmake/ApiExtractor-%{version}/ to %{_libdir}/cmake/ApiExtractor, I'
> > not sure if it's needed.    
> No idea why they would want to do that. CMake searches both directories for
> module configuration files, so there is really no advantage using one over
> other.
> Do you have a link to that opensuse package? 

No difference between the two places for cmake modules I think, but we still need a convention to treat cmake modules.

See 
http://www.pyside.org/downloads/

http://download.opensuse.org/repositories/home:/cgoncalves:/pyside:/

Comment 17 Kevin Fenzi 2010-06-21 01:55:14 UTC
CVS done (by process-cvs-requests.py).

Comment 18 Fedora Update System 2010-06-21 04:53:56 UTC
apiextractor-0.6.0-4.fc13 has been submitted as an update for Fedora 13.
http://admin.fedoraproject.org/updates/apiextractor-0.6.0-4.fc13

Comment 19 Fedora Update System 2010-06-21 21:28:11 UTC
apiextractor-0.6.0-4.fc13 has been pushed to the Fedora 13 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 apiextractor'.  You can provide feedback for this update here: http://admin.fedoraproject.org/updates/apiextractor-0.6.0-4.fc13

Comment 20 Fedora Update System 2010-06-29 15:38:11 UTC
apiextractor-0.6.0-4.fc13 has been pushed to the Fedora 13 stable repository.  If problems still persist, please make note of it in this bug report.

Comment 21 Than Ngo 2013-06-25 08:59:59 UTC
Package Change Request
======================
Package Name: apiextractor
New Branches: el6
Owners: than

Comment 22 Gwyn Ciesla 2013-06-25 11:12:29 UTC
Git done (by process-git-requests).

Comment 23 Jiri Kastner 2014-11-20 13:56:07 UTC
Package Change Request
======================
Package Name: apiextractor
New Branches: epel7
Owners: than jreznik ltinkl kkofler geertj rdieter


Note You need to log in before you can comment on or make changes to this bug.