[Bug 678634] New: Review Request: Saaghar - A Cross-Platform Persian Poetry Software

[Red Hat Bugzilla]

Please do not reply directly to this email. All additional
comments should be made in the comments box of this bug.

Summary: Review Request: Saaghar - A Cross-Platform Persian Poetry Software

https://bugzilla.redhat.com/show_bug.cgi?id=678634

Summary: Review Request: Saaghar - A Cross-Platform Persian
                    Poetry Software
           Product: Fedora
           Version: rawhide
          Platform: All
        OS/Version: Linux
            Status: NEW
          Severity: medium
          Priority: medium
         Component: Package Review
        AssignedTo: [e-mail]
        ReportedBy: [e-mail]
         QAContact: [e-mail]
                CC: [e-mail], [e-mail]
   Estimated Hours: 0.0
    Classification: Fedora

Spec URL: http://hedayat.fedorapeople.org/reviews/Saaghar/Saaghar.spec
SRPM URL:
http://hedayat.fedorapeople.org/reviews/Saaghar/Saaghar-0.7.2-1.1051.fc14.sr...

Description: 
Saaghar is a cross-platform Persian poetry software. It uses 
http://ganjoor.net database. It has lots of features:
* Tabbed UI
* Tabbed and dock-able search widgets
* Print and Print Preview
* Export, It supports exporting to "PDF", "HTML", "TeX", "CSV" and "TXT"
* Copy and Multi-selection
* Customisable interface

Koji Build: http://koji.fedoraproject.org/koji/taskinfo?taskID=2849523

[Bug 678634] Review Request: Saaghar - A Cross-Platform Persian Poetry Software

[Red Hat Bugzilla]

Please do not reply directly to this email. All additional
comments should be made in the comments box of this bug.

https://bugzilla.redhat.com/show_bug.cgi?id=678634

Raghu Udiyar  changed:

What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |[e-mail]

--- Comment #1 from Raghu Udiyar  2011-03-13 16:21:16 EDT ---
Hello Hedayat,

Few things to note :

- Consider using lower case for the spec and package name :

http://fedoraproject.org/wiki/Packaging:NamingGuidelines#Case_Sensitivity

- BuildRoot and %clean are not required any more :

http://fedoraproject.org/wiki/Packaging:Guidelines#BuildRoot_tag

- Add some description for the patches - are they Fedora specific? Can the
patches be integrated into upstream? See :

http://fedoraproject.org/wiki/Packaging:Guidelines#All_patches_should_have_a...

- Use desktop-file-validate :
http://fedoraproject.org/wiki/Packaging:Guidelines#desktop-file-install_usag...

- Looks like a typo in the release field :

Release:        1.1051%{?dist}

- You can omit the %dir in the files section :

%dir %{_datadir}/saaghar

HTH

[Bug 678634] Review Request: Saaghar - A Cross-Platform Persian Poetry Software

[Red Hat Bugzilla]

Please do not reply directly to this email. All additional
comments should be made in the comments box of this bug.

https://bugzilla.redhat.com/show_bug.cgi?id=678634

--- Comment #2 from Hedayat Vatankhah  2011-03-13 19:09:27 EDT ---
(In reply to comment #1)
> Hello Hedayat,

Hi! Thanks a lot for reviewing this package :)
> Few things to note :
> Consider using lower case for the spec and package name :
>
> http://fedoraproject.org/wiki/Packaging:NamingGuidelines#Case_Sensitivity

When I was selecting the name I checked various placing in the code and the
project and I conclude that upstream prefers Saaghar to saaghar, so I decided
to go with the former (e.g. the archive file name and the name of Debian
packages generated by upstream).
> BuildRoot and %clean are not required any more :
>
> http://fedoraproject.org/wiki/Packaging:Guidelines#BuildRoot_tag

OK, removed.
> Add some description for the patches - are they Fedora specific? Can the
>
> patches be integrated into upstream? See :
>
> http://fedoraproject.org/wiki/Packaging:Guidelines#All_patches_should_have_a...

Oops, sorry for forgetting that. Added.
> Use desktop-file-validate :
>
> http://fedoraproject.org/wiki/Packaging:Guidelines#desktop-file-install_usag... Added (was a little misinterpretation :P).
> Looks like a typo in the release field :
>
> Release:        1.1051%{?dist}

Nope. A little description added to the first patch. This is in fact a minor
version used by upstream for the version with Saaghar-upstream_update.patch
patch applied (the version is directly extracted from a version macro in source
files).
> You can omit the %dir in the files section :
>
> %dir %{_datadir}/saaghar

I don't want to add the whole directory to the main package. There is a DB
inside %{_datadir}/saaghar which is included in Saaghar-data sub-package. But I
wanted the main package to own the directory.
> HTH

Thanks again.

Updated SRPM and SPEC files are here:
SPEC: http://hedayat.fedorapeople.org/reviews/Saaghar/0.7.2-2/Saaghar.spec
SRPM:
http://hedayat.fedorapeople.org/reviews/Saaghar/0.7.2-2/Saaghar-0.7.2-2.1051...

[Bug 678634] Review Request: Saaghar - A Cross-Platform Persian Poetry Software

[Red Hat Bugzilla]

Please do not reply directly to this email. All additional
comments should be made in the comments box of this bug.

https://bugzilla.redhat.com/show_bug.cgi?id=678634

--- Comment #3 from Hedayat Vatankhah  2011-04-29 17:50:34 EDT ---
Updated to the latest upstream version:
SPEC: http://hedayat.fedorapeople.org/reviews/Saaghar/0.8.13-1/Saaghar.spec
SRPM:
http://hedayat.fedorapeople.org/reviews/Saaghar/0.8.13-1/Saaghar-0.8.13-1.fc...

Koji Build: http://koji.fedoraproject.org/koji/taskinfo?taskID=3036618

[Bug 678634] Review Request: Saaghar - A Cross-Platform Persian Poetry Software

[Red Hat Bugzilla]

Please do not reply directly to this email. All additional
comments should be made in the comments box of this bug.

https://bugzilla.redhat.com/show_bug.cgi?id=678634

--- Comment #4 from Hedayat Vatankhah  2011-05-24 16:23:59 EDT ---
Updated to 0.8.21 release:
SPEC: http://hedayat.fedorapeople.org/reviews/Saaghar/0.8.21-1/Saaghar.spec
SRPM:
http://hedayat.fedorapeople.org/reviews/Saaghar/0.8.21-1/Saaghar-0.8.21-1.fc...

[Bug 678634] Review Request: Saaghar - A Cross-Platform Persian Poetry Software

[Red Hat Bugzilla]

Please do not reply directly to this email. All additional
comments should be made in the comments box of this bug.

https://bugzilla.redhat.com/show_bug.cgi?id=678634

--- Comment #5 from Hedayat Vatankhah  2011-11-20 11:34:24 EST ---
Updated to the latest release 0.9.69 with some cleanups:
SPEC: http://hedayat.fedorapeople.org/reviews/Saaghar/0.9.69-1/Saaghar.spec
SRPM:
http://hedayat.fedorapeople.org/reviews/Saaghar/0.9.69-1/Saaghar-0.9.69-1.fc...

[Bug 678634] Review Request: Saaghar - A Cross-Platform Persian Poetry Software

[Red Hat Bugzilla]

Please do not reply directly to this email. All additional
comments should be made in the comments box of this bug.

https://bugzilla.redhat.com/show_bug.cgi?id=678634

Jiri Popelka  changed:

What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |[e-mail]
         AssignedTo|[e-mail]    |[e-mail]

[Bug 678634] Review Request: Saaghar - A Cross-Platform Persian Poetry Software

[Red Hat Bugzilla]

Please do not reply directly to this email. All additional
comments should be made in the comments box of this bug.

https://bugzilla.redhat.com/show_bug.cgi?id=678634

Jiri Popelka  changed:

What    |Removed                     |Added
----------------------------------------------------------------------------
               Flag|                            |fedora-review?

[Bug 678634] Review Request: Saaghar - A Cross-Platform Persian Poetry Software

[Red Hat Bugzilla]

Please do not reply directly to this email. All additional
comments should be made in the comments box of this bug.

https://bugzilla.redhat.com/show_bug.cgi?id=678634

--- Comment #6 from Jiri Popelka  2011-11-21 12:05:38 EST ---
[OK] MUST: rpmlint must be run on the source rpm and all binary rpms the build
produces.
Saaghar.x86_64: E: incorrect-fsf-address /usr/share/doc/Saaghar-0.9.69/README
Saaghar.x86_64: W: no-manual-page-for-binary saaghar                            
Both this problems are task for upstream.

[OK] MUST: The package must be named according to the Package Naming
Guidelines.
[OK] MUST: The spec file name must match the base package %{name}, in the
format %{name}.spec unless your package has an exemption.
[OK] MUST: The package must meet the Packaging Guidelines.
Consider removing %defattr(-,root,root,-)
https://fedoraproject.org/wiki/Packaging/Guidelines#File_Permissions

Wouldn't it be better to use URL http://sourceforge.net/projects/saaghar/ ?
Because I'm not able to switch http://pojh.iblogger.org/saaghar/
to english (there's probably not such an option) and the sourceforge page
points to it anyway.

[OK] MUST: The package must be licensed with a Fedora approved license and meet
the Licensing Guidelines .
[OK] MUST: The License field in the package spec file must match the actual
license.
[OK] MUST: If (and only if) the source package includes the text of the
license(s) in its own file, then that file, containing the text of the
license(s) for the package must be included in %doc.
[OK] MUST: The spec file must be written in American English.
[OK] MUST: The spec file for the package MUST be legible.
[OK] MUST: The sources used to build the package must match the upstream
source, as provided in the spec URL.
a72340b04c782f7f39ba12afe5688306  Saaghar-0.9.69.tar.gz
cedf5c41a75a122f94a14f78611f336c  Saaghar-data-59.90.07.xz

[OK] MUST: The package MUST successfully compile and build into binary rpms on
at least one primary architecture.
[NA] MUST: If the package does not successfully compile, build or work on an
architecture, then those architectures should be listed in the spec in
ExcludeArch.
[OK] MUST: All build dependencies must be listed in BuildRequires, except for
any that are listed in the exceptions section of the Packaging Guidelines.
qt4-devel works ok, however correct package name is qt-devel

[NA] MUST: The spec file MUST handle locales properly.
[NA] MUST: Every binary RPM package (or subpackage) which stores shared library
files (not just symlinks) in any of the dynamic linker's default paths, must
call ldconfig in %post and %postun.
[NA] MUST: Packages must NOT bundle copies of system libraries.
[NA] MUST: If the package is designed to be relocatable, the packager must
state this fact in the request for review, along with the rationalization for
relocation of that specific package.
[OK] MUST: A package must own all directories that it creates. If it does not
create a directory that it uses, then it should require a package which does
create that directory.
[OK] MUST: A Fedora package must not list a file more than once in the spec
file's %files listings.
[OK] MUST: Permissions on files must be set properly.
[OK] MUST: Each package must consistently use macros.
[OK] MUST: The package must contain code, or permissable content.
[NA] MUST: Large documentation files must go in a -doc subpackage.
[OK] MUST: If a package includes something as %doc, it must not affect the
runtime of the application.
[NA] MUST: Header files must be in a -devel package.
[NA] MUST: Static libraries must be in a -static package.
[NA] MUST: If a package contains library files with a suffix (e.g.
libfoo.so.1.1), then library files that end in .so (without suffix) must go in
a -devel package.
[NA] MUST: In the vast majority of cases, devel packages must require the base
package using a fully versioned dependency.
[NA] MUST: Packages must NOT contain any .la libtool archives, these must be
removed in the spec if they are built.
[OK] MUST: Packages containing GUI applications must include a %{name}.desktop
file, and that file must be properly installed with desktop-file-install in the
%install section.
desktop-file-validate is OK in this case
[OK] MUST: Packages must not own files or directories already owned by other
packages.
[OK] MUST: All filenames in rpm packages must be valid UTF-8.

[OK] SHOULD: The reviewer should test that the package builds in mock.
[OK] SHOULD: The reviewer should test that the package functions as described.
A package should not segfault instead of running, for example.
[-] SHOULD: Usually, subpackages other than devel should require the base
package using a fully versioned dependency.
I think Saaghar-data should require base package, but it's probably not a
problem as it is (i.e. when base package requires -data subpackage).

[-] SHOULD: your package should contain man pages for binaries/scripts. If it
doesn't, work with upstream to add them where they make sense.
See the rpmlint warning above.

[Bug 678634] Review Request: Saaghar - A Cross-Platform Persian Poetry Software

[Red Hat Bugzilla]

Please do not reply directly to this email. All additional
comments should be made in the comments box of this bug.

https://bugzilla.redhat.com/show_bug.cgi?id=678634

Jiri Popelka  changed:

What    |Removed                     |Added
----------------------------------------------------------------------------
               Flag|fedora-review?              |fedora-review+

--- Comment #7 from Jiri Popelka  2011-11-21 12:09:13 EST ---
As all the notes in the above comment are of 'nice-to-have' kind this package
can be considered Approved.

[Bug 678634] Review Request: Saaghar - A Cross-Platform Persian Poetry Software

[Red Hat Bugzilla]

Please do not reply directly to this email. All additional
comments should be made in the comments box of this bug.

https://bugzilla.redhat.com/show_bug.cgi?id=678634

--- Comment #8 from Hedayat Vatankhah  2011-11-21 12:26:00 EST ---
Thanks for the (very tidy) review (and sorry for my not-that-good review).

* Saaghar.x86_64: E: incorrect-fsf-address /usr/share/doc/Saaghar-0.9.69/README
Saaghar.x86_64: W: no-manual-page-for-binary saaghar                            
Both this problems are task for upstream.
- I'll contact upstream about them.

* Consider removing %defattr(-,root,root,-)
- OK

* Wouldn't it be better to use URL http://sourceforge.net/projects/saaghar/ ?
Because I'm not able to switch http://pojh.iblogger.org/saaghar/
to english (there's probably not such an option) and the sourceforge page
points to it anyway.
- You're right. It is a non-English website. I'll update the URL as you
suggested.

* qt4-devel works ok, however correct package name is qt-devel
- OK, will be fixed.

* I think Saaghar-data should require base package, but it's probably not a
problem as it is (i.e. when base package requires -data subpackage)
- hmmm... the base package must require the subpackage in this case, but I'm
not sure if it is also needed in the other way around. But I'll consider your
suggestion and might add that dependency too.

Thanks again.

[Bug 678634] Review Request: Saaghar - A Cross-Platform Persian Poetry Software

[Red Hat Bugzilla]

Please do not reply directly to this email. All additional
comments should be made in the comments box of this bug.

https://bugzilla.redhat.com/show_bug.cgi?id=678634

Hedayat Vatankhah  changed:

What    |Removed                     |Added
----------------------------------------------------------------------------
               Flag|                            |fedora-cvs?

--- Comment #9 from Hedayat Vatankhah  2011-11-21 12:37:54 EST ---
New Package SCM Request
=======================
Package Name: Saaghar
Short Description: A Cross-Platform Persian Poetry Software
Owners: hedayat
Branches: f15 f16
InitialCC:

[Bug 678634] Review Request: Saaghar - A Cross-Platform Persian Poetry Software

[Red Hat Bugzilla]

Please do not reply directly to this email. All additional
comments should be made in the comments box of this bug.

https://bugzilla.redhat.com/show_bug.cgi?id=678634

--- Comment #10 from Jon Ciesla  2011-11-21 13:05:24 EST ---
Git done (by process-git-requests).

[Bug 678634] Review Request: Saaghar - A Cross-Platform Persian Poetry Software

[Red Hat Bugzilla]

Please do not reply directly to this email. All additional
comments should be made in the comments box of this bug.

https://bugzilla.redhat.com/show_bug.cgi?id=678634

Fedora Update System  changed:

What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|NEW                         |MODIFIED

[Bug 678634] Review Request: Saaghar - A Cross-Platform Persian Poetry Software

[Red Hat Bugzilla]

Please do not reply directly to this email. All additional
comments should be made in the comments box of this bug.

https://bugzilla.redhat.com/show_bug.cgi?id=678634

--- Comment #11 from Fedora Update System  2011-11-21 15:06:57 EST ---
Saaghar-0.9.69-1.fc16 has been submitted as an update for Fedora 16.
https://admin.fedoraproject.org/updates/Saaghar-0.9.69-1.fc16

[Bug 678634] Review Request: Saaghar - A Cross-Platform Persian Poetry Software

[Red Hat Bugzilla]

Please do not reply directly to this email. All additional
comments should be made in the comments box of this bug.

https://bugzilla.redhat.com/show_bug.cgi?id=678634

--- Comment #12 from Fedora Update System  2011-11-21 15:07:05 EST ---
Saaghar-0.9.69-1.fc15 has been submitted as an update for Fedora 15.
https://admin.fedoraproject.org/updates/Saaghar-0.9.69-1.fc15

[Bug 678634] Review Request: Saaghar - A Cross-Platform Persian Poetry Software

[Red Hat Bugzilla]

Please do not reply directly to this email. All additional
comments should be made in the comments box of this bug.

https://bugzilla.redhat.com/show_bug.cgi?id=678634

Fedora Update System  changed:

What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|MODIFIED                    |ON_QA

--- Comment #13 from Fedora Update System  2011-11-22 19:51:21 EST ---
Saaghar-0.9.69-1.fc16 has been pushed to the Fedora 16 testing repository.

[Bug 678634] Review Request: Saaghar - A Cross-Platform Persian Poetry Software

[Red Hat Bugzilla]

Please do not reply directly to this email. All additional
comments should be made in the comments box of this bug.

https://bugzilla.redhat.com/show_bug.cgi?id=678634

Fedora Update System  changed:

What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|ON_QA                       |CLOSED
   Fixed In Version|                            |Saaghar-0.9.69-1.fc16
         Resolution|                            |ERRATA
        Last Closed|                            |2011-12-02 16:27:44

--- Comment #14 from Fedora Update System  2011-12-02 16:27:44 EST ---
Saaghar-0.9.69-1.fc16 has been pushed to the Fedora 16 stable repository.

[Bug 678634] Review Request: Saaghar - A Cross-Platform Persian Poetry Software

[Red Hat Bugzilla]

Please do not reply directly to this email. All additional
comments should be made in the comments box of this bug.

https://bugzilla.redhat.com/show_bug.cgi?id=678634

Fedora Update System  changed:

What    |Removed                     |Added
----------------------------------------------------------------------------
   Fixed In Version|Saaghar-0.9.69-1.fc16       |Saaghar-0.9.69-1.fc15

--- Comment #15 from Fedora Update System  2011-12-02 16:29:02 EST ---
Saaghar-0.9.69-1.fc15 has been pushed to the Fedora 15 stable repository.