Bug 948105 - Review Request: rubygem-ronn - Manual authoring tool
Summary: Review Request: rubygem-ronn - Manual authoring tool
Keywords:
Status: CLOSED ERRATA
Alias: None
Product: Fedora
Classification: Fedora
Component: Package Review
Version: rawhide
Hardware: All
OS: Linux
medium
medium
Target Milestone: ---
Assignee: Mamoru TASAKA
QA Contact: Fedora Extras Quality Assurance
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2013-04-04 02:55 UTC by Rick Elrod
Modified: 2013-05-15 17:27 UTC (History)
3 users (show)

Fixed In Version: rubygem-ronn-0.7.3-3.fc19
Clone Of:
Environment:
Last Closed: 2013-05-15 17:27:44 UTC
Type: ---
Embargoed:
mtasaka: fedora-review+
pbabinca: fedora-cvs+


Attachments (Terms of Use)

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.


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