Bug 668240
| Summary: | Review Request: clapham - Railroad diagram generator | ||
|---|---|---|---|
| Product: | [Fedora] Fedora | Reporter: | Eric Smith <spacewar> |
| Component: | Package Review | Assignee: | Mario Blättermann <mario.blaettermann> |
| Status: | CLOSED ERRATA | QA Contact: | Fedora Extras Quality Assurance <extras-qa> |
| Severity: | medium | Docs Contact: | |
| Priority: | medium | ||
| Version: | rawhide | CC: | fedora-package-review, mario.blaettermann, martin.gieseking, notting |
| Target Milestone: | --- | Flags: | mario.blaettermann:
fedora-review+
dennis: fedora-cvs+ |
| Target Release: | --- | ||
| Hardware: | All | ||
| OS: | Linux | ||
| Whiteboard: | |||
| Fixed In Version: | clapham-0.1.003-4.fc15 | Doc Type: | Bug Fix |
| Doc Text: | Story Points: | --- | |
| Clone Of: | Environment: | ||
| Last Closed: | 2011-05-17 01:04:59 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
Eric Smith
2011-01-09 11:05:50 UTC
$ rpmlint -v * clapham.src: I: checking clapham.src: I: checking-url http://clapham.hydromatic.net/ (timeout 10 seconds) clapham.src: I: checking-url http://downloads.sourceforge.net/clapham/clapham-0.1.003-src.zip (timeout 10 seconds) clapham.spec: I: checking-url http://downloads.sourceforge.net/clapham/clapham-0.1.003-src.zip (timeout 10 seconds) 1 packages and 1 specfiles checked; 0 errors, 0 warnings. No issues from rpmlint, OK. Some hints anyway: - For better consistency, replace all occurences of th package name with %{name}. - In my mind, it's better to use the universal "install" command instead of "cp". - To avoid ambiguity, you could append "...for computer languages" to summary. Otherwise, readers could assume it is a generator for railway maps ;-) Thanks for reviewing this!
Changed more occurences of package name to %{name} per your suggestion.
I don't see how install is in any way better than cp here. However, I have replaced the first two uses of cp with install. Since install does not appear to have a recursive option, and use of find with install definitely doesn't improve the clarity, I have retained the use of cp -a for that one.
Changed the summary per your suggestion.
Spec URL: http://fedorapeople.org/~brouhaha/clapham/clapham.spec
SRPM URL:
http://fedorapeople.org/~brouhaha/clapham/clapham-0.1.003-2.fc14.src.rpm
Eric, please also add short comments to the spec file about what the patches do. The license of the package isn't GPLv2+ because of the addition "or (at your option) any later version approved by The Eigenbase Project" given in the source file headers. What are the approved versions? I can't find any information on this. If GPLv3 has been approved, the License tag would be "GPLv2 or GPLv3". Otherwise, it's just GPLv2. You should ask upstream for clarification. No word from upstream yet. I've changed it to GPLv2 with a comment explaining the reason. I also added comments about the patches. Thanks for the suggestions. Spec URL: http://fedorapeople.org/~brouhaha/clapham/clapham.spec SRPM URL: http://fedorapeople.org/~brouhaha/clapham/clapham-0.1.003-3.fc14.src.rpm Sorry for the delay. $ rpmlint -v clapham* clapham.src: I: checking clapham.src: I: checking-url http://clapham.hydromatic.net/ (timeout 10 seconds) clapham.src: I: checking-url http://downloads.sourceforge.net/clapham/clapham-0.1.003-src.zip (timeout 10 seconds) clapham.noarch: I: checking clapham.noarch: I: checking-url http://clapham.hydromatic.net/ (timeout 10 seconds) clapham.noarch: W: no-manual-page-for-binary clapham clapham-javadoc.noarch: I: checking clapham-javadoc.noarch: W: spelling-error Summary(en_US) Javadocs -> Java docs, Java-docs, Javanese clapham-javadoc.noarch: I: checking-url http://clapham.hydromatic.net/ (timeout 10 seconds) clapham.spec: I: checking-url http://downloads.sourceforge.net/clapham/clapham-0.1.003-src.zip (timeout 10 seconds) 3 packages and 1 specfiles checked; 0 errors, 2 warnings. Koji scratch build: http://koji.fedoraproject.org/koji/taskinfo?taskID=3029051 Informal review will follow immediately. ---------------------------------
key:
[+] OK
[.] OK, not applicable
[X] needs work
---------------------------------
[+] MUST: The package must be named according to the Package Naming Guidelines.
[+] MUST: The spec file name must match the base package %{name}.
[+] MUST: The package must meet the Packaging Guidelines.
[+] MUST: The package must be licensed with a Fedora approved license.
GPLv2
[+] MUST: The License field in the package spec file must match the actual
license.
-see the note in the spec file.
[+] MUST: The file containing the text of the license(s) for the package must
be included in %doc.
[x] MUST: The spec file must be written in American English.
- Please correct the small spelling error.
[+] MUST: The spec file for the package MUST be legible.
[+] MUST: The sources used to build the package must match the upstream source.
$ md5sum clapham*
97a38474095b142936d6bb922a178773 clapham-0.1.003-src.zip
97a38474095b142936d6bb922a178773 clapham-0.1.003-src.zip.packaged
[+] MUST: The package MUST successfully compile and build into binary rpms on
at least one primary architecture.
- Succesful Koji build available, see above.
[.] MUST: If the package does not successfully compile, build or work on an
architecture, ...
[+] MUST: All build dependencies must be listed in BuildRequires.
[.] MUST: The spec file MUST handle locales properly.
[.] MUST: If a package installs files below %{_datadir}/icons, the icon cache
must be updated.
[.] MUST: Packages storing shared library files (not just symlinks) must call
ldconfig in %post and %postun.
[.] MUST: Packages must NOT bundle copies of system libraries.
[.] MUST: If the package is designed to be relocatable, ...
[+] MUST: A package must own all directories that it creates.
[+] MUST: A Fedora package must not list a file more than once in %files.
[+] MUST: Permissions on files must be set properly.
[x] MUST: Packages must not provide RPM dependency information when that
information is not global in nature, or are otherwise handled.
I miss the dependency to the base package:
Requires: Requires: %{name} = %{version}-%{release}
This dependency is not picked up automatically.
[.] MUST: When filtering automatically generated RPM dependency information,
the filtering system implemented by Fedora must be used.
[+] MUST: Each package must consistently use macros.
[+] MUST: The package must contain code, or permissable content.
[.] MUST: Large documentation files must go in a -doc subpackage.
[+] MUST: Files in %doc must not affect the runtime of the application.
[.] MUST: Header files must be in a -devel package.
[.] MUST: Static libraries must be in a -static package.
[.] MUST: If a package contains library files with a suffix (e.g.
libfoo.so.1.1), ...
[.] MUST: devel packages must require the base package using a fully versioned
dependency.
[.] MUST: Packages must NOT contain any .la libtool archives.
[.] MUST: Packages containing GUI applications must include a %{name}.desktop
file
[.] MUST: .desktop files must be properly installed with desktop-file-install
in the %install section.
[+] MUST: Packages must not own files or directories already owned by other
packages.
[+] MUST: All filenames in rpm packages must be valid UTF-8.
[.] SHOULD: If the source package does not include license text(s) as a
separate file from upstream, the packager SHOULD query upstream...
[+] SHOULD: Timestamps of files should be preserved.
[+] SHOULD: The reviewer should test that the package builds in mock.
See Koji build above (which uses mock anyway)
[+] SHOULD: The reviewer should test that the package functions as described.
I assume the packager has tested it.
[.] SHOULD: If scriptlets are used, those scriptlets must be sane.
[.] SHOULD: Usually, subpackages other than devel should require the base
package using a fully versioned dependency.
[.] SHOULD: pkgconfig(.pc) files should be placed in a -devel pkg.
[.] SHOULD: If the package has file dependencies outside of /etc, /bin, /sbin,
/usr/bin, or /usr/sbin ...
[.] SHOULD: Your package should contain man pages for binaries/scripts.
Spec URL: http://fedorapeople.org/~brouhaha/clapham/clapham.spec SRPM URL: http://fedorapeople.org/~brouhaha/clapham/clapham-0.1.003-4.fc14.src.rpm I added the subpackage dependency. I'm not aware of any spelling error. If you're referring to the warning from rpmlint, that is spurious. "Javadocs" is spelled correctly, and is the preferred description of javadoc subpackages. For instance, do a "yum search javadocs" and look at the summaries. If there is another spelling error that I am not aware of, please let me know specifically what it is, and I'll be happy to fix it. Thanks for reviewing this package! Eric (In reply to comment #7) > I'm not aware of any spelling error. Sorry for the blurb, this was an artifact from a former review. Your package looks good now. ------------------------------ PACKAGE APPROVED ------------------------------ New Package SCM Request ======================= Package Name: clapham Short Description: Railroad diagram generator for computer languages Owners: brouhaha Branches: f14 f15 el6 InitialCC: Git done (by process-git-requests). clapham-0.1.003-4.fc15 has been submitted as an update for Fedora 15. https://admin.fedoraproject.org/updates/clapham-0.1.003-4.fc15 clapham-0.1.003-4.fc14 has been submitted as an update for Fedora 14. https://admin.fedoraproject.org/updates/clapham-0.1.003-4.fc14 clapham-0.1.003-4.el6 has been submitted as an update for Fedora EPEL 6. https://admin.fedoraproject.org/updates/clapham-0.1.003-4.el6 clapham-0.1.003-4.el6 has been pushed to the Fedora EPEL 6 testing repository. clapham-0.1.003-4.fc14 has been pushed to the Fedora 14 stable repository. clapham-0.1.003-4.fc15 has been pushed to the Fedora 15 stable repository. |