Bug 948105

Summary: Review Request: rubygem-ronn - Manual authoring tool
Product: [Fedora] Fedora Reporter: Rick Elrod <relrod>
Component: Package ReviewAssignee: Mamoru TASAKA <mtasaka>
Status: CLOSED ERRATA QA Contact: Fedora Extras Quality Assurance <extras-qa>
Severity: medium Docs Contact:
Priority: medium    
Version: rawhideCC: mtasaka, notting, package-review
Target Milestone: ---Flags: mtasaka: fedora-review+
pbabinca: fedora-cvs+
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: rubygem-ronn-0.7.3-3.fc19 Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2013-05-15 17:27:44 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 Rick Elrod 2013-04-04 02:55:17 UTC
Spec URL: http://codeblock.fedorapeople.org/packages/rubygem-ronn/rubygem-ronn.spec
SRPM URL: http://codeblock.fedorapeople.org/packages/rubygem-ronn/rubygem-ronn-0.7.3-1.fc18.noarch.rpm
Description:

Ronn builds manuals. It converts simple, human readable text files to
roff for terminal display, and also to HTML for the web.

The source format includes all of Markdown but has a more rigid structure and
syntax extensions for features commonly found in man pages (definition lists,
link notation, etc.). The ronn-format(7) manual page defines the format in
detail.


Fedora Account System Username: codeblock

Comment 1 Mamoru TASAKA 2013-04-04 04:16:14 UTC
Hello, Ricky:
If you want review swap, I would appreciate it if you would swap this bug with one of my review requests (e.g. bug 922460 ).

By the way, "ruby(release)" is provided by ruby only on F-19+, not on F-18 and below while your srpm contains ".fc18". Is this what you intended?

Comment 2 Mamoru TASAKA 2013-04-04 04:18:02 UTC
Anyway taking.

Comment 3 Mamoru TASAKA 2013-04-04 04:20:07 UTC
Oh, please upload srpm, not rebuilt rpm, thank you.

Comment 4 Mamoru TASAKA 2013-04-04 04:55:16 UTC
* BuildRequires
  - srpm rebuilt from your spec file won't build on koji F20.
    Please add appropriate BuildRequires (at least rubygem-devel is
    needed)

* Documentation etc
  - Please mark AUTHORS CHANGES COPYING README.md %{gem_docdir} as %doc
    (at least COPYING must be marked as %doc)
  - INSTALLING file is not needed as installing is done by rpm
  - Also Rakefile is not needed as Rakefile is like Makefiles in
    autotools based files, which we do not package into binary rpms.
  - It is recommended to split out %gem_docdir into -doc rpm.
  - test/ directory should not be packaged into binary rpm:
    https://fedoraproject.org/wiki/Packaging:Ruby?rd=Packaging/Ruby#Running_test_suites

* Virtual Requires
  - For (Build)Requires, please use "Requires: rubygem(hpricot)" style instead of
    directly writing rpms' names (i.e. instead of "Requires: rubygem-hpricot")
    so as to be consistent of other packages.

* Running test suites
  - As this gem contains test/ directory, please add %check seciton and
    execute some test program in %check:
    https://fedoraproject.org/wiki/Packaging:Ruby?rd=Packaging/Ruby#Running_test_suites

Comment 5 Rick Elrod 2013-04-04 06:20:51 UTC
Thanks for the feedback, and sorry I uploaded the wrong RPM, I didn't even notice. :)

I believe I've addressed everything you've pointed out so far - and yes, I will happily review one of yours in return. Look for it tomorrow.

New SRPM: http://codeblock.fedorapeople.org/packages/rubygem-ronn/rubygem-ronn-0.7.3-2.fc18.src.rpm
New Spec: http://codeblock.fedorapeople.org/packages/rubygem-ronn/rubygem-ronn.spec

Comment 6 Mamoru TASAKA 2013-04-05 07:46:52 UTC
For -2:

* Requires etc
  - On F-19+, rubygem-based rpm must have "Requires: ruby(release)"
    and On F-18-, rubygem-based rpm must have "Requires: ruby(abi) = 1.9.1".
    One trick is
%if 0%{?fedora} >= 19
Requires: ruby(release)
%else
Requires: ruby(abi) = 1.9.1
%endif

* Documentation
  - What I meant is that %gem_instdir/AUTHORS and etc should be marked as %doc.
    Currently these files (%gem_instdir/AUTHORS, %gem_instdir/CHANGES, etc)
    are not marked as %doc, and the same files are copied into
    /usr/share/doc/%{name}-%{version} (with marked as doc).

    It is recommended to write %files entry more verbosely, like
%files
%dir %{gem_instdir}
%doc %{gem_instdir}/[A-Z]*
%{gem_libdir}
%{gem_instdir}/foobar
....

  - Also, rm -rf %{buildroot}%{gem_dir}/{INSTALLING,Rakefile,test} should be
    rm -rf %{buildroot}%{gem_instdir}/{INSTALLING,Rakefile,test}

Comment 7 Rick Elrod 2013-04-05 10:57:45 UTC
New SRPM: http://codeblock.fedorapeople.org/packages/rubygem-ronn/rubygem-ronn-0.7.3-3.fc19.src.rpm
New Spec: http://codeblock.fedorapeople.org/packages/rubygem-ronn/rubygem-ronn.spec

Thanks for explaining the F18- and F19+ trick. And hopefully I got the %files section right this time. :)

Comment 8 Mamoru TASAKA 2013-04-07 07:24:15 UTC
Okay, clean.

----------------------------------------------------------------
    This package (rubygem-ronn) is APPROVED by mtasaka
----------------------------------------------------------------

Comment 9 Rick Elrod 2013-04-07 09:30:09 UTC
New Package SCM Request
=======================
Package Name: rubygem-ronn
Short Description: Manual authoring tool
Owners: codeblock
Branches: f18 f19

Comment 10 Pavol Babinčák 2013-04-08 09:03:02 UTC
Git done (by process-git-requests).

Comment 11 Mamoru TASAKA 2013-05-07 03:50:10 UTC
Would you build this package on koji?

Comment 12 Rick Elrod 2013-05-07 04:01:02 UTC
Yep, will do so right now.

Comment 13 Fedora Update System 2013-05-07 04:24:37 UTC
rubygem-ronn-0.7.3-3.fc19 has been submitted as an update for Fedora 19.
https://admin.fedoraproject.org/updates/rubygem-ronn-0.7.3-3.fc19

Comment 14 Mamoru TASAKA 2013-05-07 05:13:07 UTC
Okay, thank you.

Comment 15 Fedora Update System 2013-05-07 20:42:19 UTC
rubygem-ronn-0.7.3-3.fc19 has been pushed to the Fedora 19 testing repository.

Comment 16 Fedora Update System 2013-05-15 17:27:44 UTC
rubygem-ronn-0.7.3-3.fc19 has been pushed to the Fedora 19 stable repository.