Bug 1581240 - Review Request: pcb-rnd - Printed Circuit Board (PCB) editor
Summary: Review Request: pcb-rnd - Printed Circuit Board (PCB) editor
Keywords:
Status: CLOSED RAWHIDE
Alias: None
Product: Fedora
Classification: Fedora
Component: Package Review
Version: rawhide
Hardware: All
OS: Linux
unspecified
medium
Target Milestone: ---
Assignee: Robert-André Mauchin 🐧
QA Contact: Fedora Extras Quality Assurance
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2018-05-22 12:14 UTC by Alain V.
Modified: 2019-02-04 05:46 UTC (History)
2 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2019-02-04 05:46:35 UTC
Type: ---
Embargoed:
zebob.m: fedora-review+


Attachments (Terms of Use)

Description Alain V. 2018-05-22 12:14:59 UTC
Spec URL: See COPR:  https://copr.fedorainfracloud.org/coprs/avigne/pcb-rnd-1.2.8/
SRPM URL: 
Description: pcb-rnd is hosted at http://repo.hu/projects/pcb-rnd/ . I am Alain, one of the developers.
Fedora Account System Username:avigne

Comment 1 Robert-André Mauchin 🐧 2018-05-29 18:28:50 UTC
 - Use the %configure macro instead of ./configure

 - Use %{_prefix} instead of /usr and %{_usr}

%if %{debug} == 1
        prefix=/usr --debug
%else
        prefix=/usr --symbols
%endif

%define plugindir %{_usr}/lib/%{name}/plugins

 - Don't comment out %install

#%%install

 - Add a changelog entry

 - Separate the license by "and":

License:        GPLv2+ and LGPLv2+ and BSD

 - Shouldn't the plugins be in /usr/lib64 on 64bits arches?

 - Install the license file COPYING in %files and add the %doc too:

%files core
%license COPYING
%doc README Changelog AUTHORS Release_notes


I can't sponsor, try introducing yourself to the devel mailing list and do some informal reviews to show you understand the guidelines and to find a sponsor.

Comment 2 Alain V. 2018-06-06 11:38:55 UTC
Than you so much Robert-André for this valuable feed-back.

I implemented most of your proposals, 2 of them I can't at the moment:

1. ./configure   is NOT the autotool configure binary we might all expect. This is a very small shell script, launching the configuration process (which is fully managed by the application itself)

2. %{_prefix}/lib  is reported as an error by rpmlint, and suggestion is to use %{_libdir}. Trouble is, this macro expands to lib or lib64, depending on system, but at the moment, the configuration process can only handle lib (may be next version ?). In my 64-bit system, this leads to a failed build.

Today, I successfully COPR build the latest pcb-rnd new release in
https://copr.fedorainfracloud.org/coprs/avigne/pcb-rnd/


Finding a sponsor is now the most difficult part. I introduced myself on the
packaging-owner.org, with no success.
You do suggest I introduce myself to devel.org, correct ?

Best regards
Alain

Comment 3 Robert-André Mauchin 🐧 2018-06-06 15:31:38 UTC
Yes on the devel list.

Comment 4 Robert-André Mauchin 🐧 2018-06-25 16:27:46 UTC
Using SPEC URL: https://copr-be.cloud.fedoraproject.org/results/avigne/pcb-rnd/fedora-rawhide-x86_64/00763485-pcb-rnd/pcb-rnd.spec

SRPM URL: https://copr-be.cloud.fedoraproject.org/results/avigne/pcb-rnd/fedora-rawhide-x86_64/00763485-pcb-rnd/pcb-rnd-2.0.0-1.fc29.src.rpm

 -  Add a comment explaining the licenses breakdown:

[!]: If the package is under multiple licenses, the licensing breakdown


 - Use %{_prefix} instead of %{_usr}

%{_prefix}/lib/%{name}/*.scm

 - Shouldn't be needed:

%exclude %{_usr}/lib/debug/*

Debug files are automatically picked up by the debug packages.

 - Own these directories:

[!]: Package must own all directories that it creates.
     Note: Directories without known owners: /usr/share/pcb-rnd, /usr/lib
     /pcb-rnd, /usr/lib/pcb-rnd/plugins, /usr/share/doc/pcb-rnd

 Note: remove the * here to also own the dirs:

%files doc
%doc %{_docdir}/%{name}

%files core
%{_bindir}/fp2anim
%{_bindir}/fp2subc
%{_bindir}/gsch2%{name}
%{_bindir}/pcb-prj2lht
%{_bindir}/%{name}
%{_bindir}/pcb-strip
%{_mandir}/man1/*
%{_datadir}/%{name}
%dir %{_prefix}/lib/%{name}
%dir %{_prefix}/lib/%{name}/plugins
%{_prefix}/lib/%{name}/*.scm

 - Notify upstream about the erroneous FSF address in COPYING:

pcb-rnd-core.x86_64: E: incorrect-fsf-address /usr/share/licenses/pcb-rnd-core/COPYING

 - Use %global, not %define:

[!]: Spec use %global instead of %define unless justified.
     Note: %define requiring justification: %define debug 0, %define
     plugindir %{_usr}/lib/%{name}/plugins, #%%define svn 15165




Package Review
==============

Legend:
[x] = Pass, [!] = Fail, [-] = Not applicable, [?] = Not evaluated
[ ] = Manual review needed


===== MUST items =====

C/C++:
[x]: Package does not contain kernel modules.
[x]: Package contains no static executables.
[x]: Development (unversioned) .so files in -devel subpackage, if present.
     Note: Unversioned so-files in private %_libdir subdirectory (see
     attachment). Verify they are not in ld path.
[x]: Header files in -devel subpackage, if present.
[x]: Package does not contain any libtool archives (.la)
[x]: Rpath absent or only used for internal libs.

Generic:
[x]: Package is licensed with an open-source compatible license and meets
     other legal requirements as defined in the legal section of Packaging
     Guidelines.
[x]: License field in the package spec file matches the actual license.
     Note: Checking patched sources after %prep for licenses. Licenses
     found: "GPL", "LGPL (v2 or later)", "GPL (v2 or later)", "GPL (v3 or
     later)", "Unknown or generated", "*No copyright* GPL", "GPL (v2 or
     later) (with incorrect FSF address)", "BSD (3 clause)", "GPL (v2)
     (with incorrect FSF address)", "LGPL (v2.1 or later)", "GPL (v2)".
     2646 files have unknown license. Detailed output of licensecheck in
     /home/bob/packaging/review/pcb-rnd/review-pcb-rnd/licensecheck.txt
[x]: License file installed when any subpackage combination is installed.
[!]: If the package is under multiple licenses, the licensing breakdown
     must be documented in the spec.
[-]: Package requires other packages for directories it uses.
     Note: No known owner of /usr/lib/pcb-rnd, /usr/share/pcb-rnd,
     /usr/share/doc/pcb-rnd
[!]: Package must own all directories that it creates.
     Note: Directories without known owners: /usr/share/pcb-rnd, /usr/lib
     /pcb-rnd, /usr/lib/pcb-rnd/plugins, /usr/share/doc/pcb-rnd
[x]: Package does not own files or directories owned by other packages.
[x]: %build honors applicable compiler flags or justifies otherwise.
[x]: Package contains no bundled libraries without FPC exception.
[x]: Changelog in prescribed format.
[x]: Sources contain only permissible code or content.
[-]: Package contains desktop file if it is a GUI application.
[-]: Development files must be in a -devel package
[x]: Package uses nothing in %doc for runtime.
[!]: Package consistently uses macros (instead of hard-coded directory
     names).
[x]: Package is named according to the Package Naming Guidelines.
[x]: Package does not generate any conflict.
[x]: Package obeys FHS, except libexecdir and /usr/target.
[-]: If the package is a rename of another package, proper Obsoletes and
     Provides are present.
[x]: Requires correct, justified where necessary.
[x]: Spec file is legible and written in American English.
[-]: Package contains systemd file(s) if in need.
[x]: Useful -debuginfo package or justification otherwise.
[x]: Package is not known to require an ExcludeArch tag.
[-]: Large documentation must go in a -doc subpackage. Large could be size
     (~1MB) or number of files.
     Note: Documentation size is 51200 bytes in 4 files.
[x]: Package complies to the Packaging Guidelines
[x]: Package successfully compiles and builds into binary rpms on at least
     one supported primary architecture.
[x]: Package installs properly.
[x]: Rpmlint is run on all rpms the build produces.
     Note: There are rpmlint messages (see attachment).
[x]: Package uses either %{buildroot} or $RPM_BUILD_ROOT
[x]: Package does not run rm -rf %{buildroot} (or $RPM_BUILD_ROOT) at the
     beginning of %install.
[x]: Macros in Summary, %description expandable at SRPM build time.
[x]: Dist tag is present.
[x]: Package does not contain duplicates in %files.
[x]: Package use %makeinstall only when make install DESTDIR=... doesn't
     work.
[x]: Package is named using only allowed ASCII characters.
[x]: Package does not use a name that already exists.
[x]: Package is not relocatable.
[x]: Sources used to build the package match the upstream source, as
     provided in the spec URL.
[x]: Spec file name must match the spec package %{name}, in the format
     %{name}.spec.
[x]: File names are valid UTF-8.
[x]: Packages must not store files under /srv, /opt or /usr/local

===== SHOULD items =====

Generic:
[-]: If the source package does not include license text(s) as a separate
     file from upstream, the packager SHOULD query upstream to include it.
[x]: Final provides and requires are sane (see attachments).
[x]: Fully versioned dependency in subpackages if applicable.
     Note: No Requires: %{name}%{?_isa} = %{version}-%{release} in pcb-rnd-
     core , pcb-rnd-auto , pcb-rnd-cloud , pcb-rnd-debug , pcb-rnd-export-
     extra , pcb-rnd-export-sim , pcb-rnd-export , pcb-rnd-extra , pcb-rnd-
     hid-gtk2-gdk , pcb-rnd-hid-gtk2-gl , pcb-rnd-hid-lesstif , pcb-rnd-
     import-geo , pcb-rnd-import-net , pcb-rnd-io-alien , pcb-rnd-io-
     standard , pcb-rnd-lib-gl , pcb-rnd-lib-gtk , pcb-rnd-lib-gui , pcb-
     rnd-lib-io
[?]: Package functions as described.
[x]: Latest version is packaged.
[x]: Package does not include license text files separate from upstream.
[-]: Description and summary sections in the package spec file contains
     translations for supported Non-English languages, if available.
[x]: Package should compile and build into binary rpms on all supported
     architectures.
[-]: %check is present and all tests pass.
[x]: Packages should try to preserve timestamps of original installed
     files.
[!]: Spec use %global instead of %define unless justified.
     Note: %define requiring justification: %define debug 0, %define
     plugindir %{_usr}/lib/%{name}/plugins, #%%define svn 15165
[x]: Reviewer should test that the package builds in mock.
[x]: Buildroot is not present
[x]: Package has no %clean section with rm -rf %{buildroot} (or
     $RPM_BUILD_ROOT)
[x]: No file requires outside of /etc, /bin, /sbin, /usr/bin, /usr/sbin.
[x]: Packager, Vendor, PreReq, Copyright tags should not be in spec file
[x]: Sources can be downloaded from URI in Source: tag
[x]: SourceX is a working URL.

===== EXTRA items =====

Generic:
[x]: Rpmlint is run on debuginfo package(s).
     Note: No rpmlint messages.
[x]: Rpmlint is run on all installed packages.
     Note: There are rpmlint messages (see attachment).
[x]: Large data in /usr/share should live in a noarch subpackage if package
     is arched.
[x]: Spec file according to URL is the same as in SRPM.


Rpmlint
-------
Checking: pcb-rnd-2.0.0-1.fc29.x86_64.rpm
          pcb-rnd-core-2.0.0-1.fc29.x86_64.rpm
          pcb-rnd-doc-2.0.0-1.fc29.noarch.rpm
          pcb-rnd-auto-2.0.0-1.fc29.x86_64.rpm
          pcb-rnd-cloud-2.0.0-1.fc29.x86_64.rpm
          pcb-rnd-debug-2.0.0-1.fc29.x86_64.rpm
          pcb-rnd-export-extra-2.0.0-1.fc29.x86_64.rpm
          pcb-rnd-export-sim-2.0.0-1.fc29.x86_64.rpm
          pcb-rnd-export-2.0.0-1.fc29.x86_64.rpm
          pcb-rnd-extra-2.0.0-1.fc29.x86_64.rpm
          pcb-rnd-hid-gtk2-gdk-2.0.0-1.fc29.x86_64.rpm
          pcb-rnd-hid-gtk2-gl-2.0.0-1.fc29.x86_64.rpm
          pcb-rnd-hid-lesstif-2.0.0-1.fc29.x86_64.rpm
          pcb-rnd-import-geo-2.0.0-1.fc29.x86_64.rpm
          pcb-rnd-import-net-2.0.0-1.fc29.x86_64.rpm
          pcb-rnd-io-alien-2.0.0-1.fc29.x86_64.rpm
          pcb-rnd-io-standard-2.0.0-1.fc29.x86_64.rpm
          pcb-rnd-lib-gl-2.0.0-1.fc29.x86_64.rpm
          pcb-rnd-lib-gtk-2.0.0-1.fc29.x86_64.rpm
          pcb-rnd-lib-gui-2.0.0-1.fc29.x86_64.rpm
          pcb-rnd-lib-io-2.0.0-1.fc29.x86_64.rpm
          pcb-rnd-debuginfo-2.0.0-1.fc29.x86_64.rpm
          pcb-rnd-debugsource-2.0.0-1.fc29.x86_64.rpm
          pcb-rnd-2.0.0-1.fc29.src.rpm
pcb-rnd.x86_64: E: no-binary
pcb-rnd.x86_64: W: no-documentation
pcb-rnd-core.x86_64: E: incorrect-fsf-address /usr/share/licenses/pcb-rnd-core/COPYING
pcb-rnd-auto.x86_64: W: spelling-error Summary(en_US) Autoroute -> Auto route, Auto-route, Automate
pcb-rnd-auto.x86_64: W: spelling-error Summary(en_US) autoplace -> auto place, auto-place, outplace
pcb-rnd-auto.x86_64: W: no-documentation
pcb-rnd-cloud.x86_64: W: spelling-error %description -l en_US edakrill -> espadrille
pcb-rnd-cloud.x86_64: W: spelling-error %description -l en_US gedasymbols -> symbols
pcb-rnd-cloud.x86_64: W: no-documentation
pcb-rnd-debug.x86_64: W: no-dependency-on pcb-rnd/pcb-rnd-libs/libpcb-rnd
pcb-rnd-debug.x86_64: W: no-documentation
pcb-rnd-export-extra.x86_64: W: spelling-error %description -l en_US fidocadj -> aficionado
pcb-rnd-export-extra.x86_64: W: spelling-error %description -l en_US ipc -> pic, inc
pcb-rnd-export-extra.x86_64: W: spelling-error %description -l en_US lpr -> pr, ppr, Apr
pcb-rnd-export-extra.x86_64: W: no-documentation
pcb-rnd-export-sim.x86_64: W: spelling-error %description -l en_US openems -> openers, open ems, open-ems
pcb-rnd-export-sim.x86_64: W: no-documentation
pcb-rnd-export.x86_64: W: spelling-error %description -l en_US svg -> avg, sag, VG
pcb-rnd-export.x86_64: W: spelling-error %description -l en_US ps -> PS, pa, pd
pcb-rnd-export.x86_64: W: spelling-error %description -l en_US eps -> esp, rps, es
pcb-rnd-export.x86_64: W: spelling-error %description -l en_US png -> pg, ping, pang
pcb-rnd-export.x86_64: W: spelling-error %description -l en_US jpeg -> JPEG, peg, j peg
pcb-rnd-export.x86_64: W: spelling-error %description -l en_US gerber -> Gerber, Berber, Ferber
pcb-rnd-export.x86_64: W: spelling-error %description -l en_US openscad -> open scad, open-scad, opens cad
pcb-rnd-export.x86_64: W: spelling-error %description -l en_US xy -> x, y, xi
pcb-rnd-export.x86_64: W: no-documentation
pcb-rnd-extra.x86_64: W: spelling-error %description -l en_US subcircuits -> sub circuits, sub-circuits, circuits
pcb-rnd-extra.x86_64: W: no-documentation
pcb-rnd-hid-gtk2-gdk.x86_64: W: no-documentation
pcb-rnd-hid-gtk2-gl.x86_64: W: spelling-error Summary(en_US) opengl -> opening
pcb-rnd-hid-gtk2-gl.x86_64: W: spelling-error %description -l en_US opengl -> opening
pcb-rnd-hid-gtk2-gl.x86_64: W: no-documentation
pcb-rnd-hid-lesstif.x86_64: W: no-documentation
pcb-rnd-import-geo.x86_64: W: no-documentation
pcb-rnd-import-net.x86_64: W: spelling-error Summary(en_US) Netlist -> Net list, Net-list, Listerine
pcb-rnd-import-net.x86_64: W: spelling-error %description -l en_US netlist -> net list, net-list, Listerine
pcb-rnd-import-net.x86_64: W: spelling-error %description -l en_US edif -> edify, edit, ed if
pcb-rnd-import-net.x86_64: W: spelling-error %description -l en_US ltspice -> spice
pcb-rnd-import-net.x86_64: W: spelling-error %description -l en_US gschem -> gs chem, gs-chem, scheme
pcb-rnd-import-net.x86_64: W: spelling-error %description -l en_US tinycad -> tiny cad, tiny-cad, tinny
pcb-rnd-import-net.x86_64: W: no-documentation
pcb-rnd-io-alien.x86_64: W: spelling-error %description -l en_US protel -> propel, pro tel, pro-tel
pcb-rnd-io-alien.x86_64: W: spelling-error %description -l en_US autotrax -> autocrat
pcb-rnd-io-alien.x86_64: W: no-documentation
pcb-rnd-io-standard.x86_64: W: spelling-error %description -l en_US tEDAx -> ted Ax, ted-ax, dated
pcb-rnd-io-standard.x86_64: W: spelling-error %description -l en_US gEDA -> egad, aged, Leda
pcb-rnd-io-standard.x86_64: W: no-documentation
pcb-rnd-lib-gl.x86_64: W: spelling-error Summary(en_US) opengl -> opening
pcb-rnd-lib-gl.x86_64: W: spelling-error %description -l en_US opengl -> opening
pcb-rnd-lib-gl.x86_64: W: no-documentation
pcb-rnd-lib-gtk.x86_64: W: no-documentation
pcb-rnd-lib-gui.x86_64: W: no-documentation
pcb-rnd-lib-io.x86_64: W: no-documentation
pcb-rnd.src:206: W: configure-without-libdir-spec
24 packages and 0 specfiles checked; 2 errors, 52 warnings.

Comment 5 Alain V. 2018-08-29 12:07:24 UTC
Thank you very much for this detailed analysis, Robert-Andre.

Today, a new pcb-rnd release is available [1], and I successfully built Fedora packages [2] (+RHEL + Mageia) with a modified .spec file, following your suggestions.

Am I getting closer to the target ?
BR, Alain
[1] http://repo.hu/projects/pcb-rnd/news.html
[2] https://copr.fedorainfracloud.org/coprs/avigne/pcb-rnd/

Comment 6 Robert-André Mauchin 🐧 2018-08-30 19:25:40 UTC
Still not fixed:


 -  Add a comment explaining the licenses breakdown:

[!]: If the package is under multiple licenses, the licensing breakdown


 - Use %{_prefix} instead of %{_usr}

 - Shouldn't be needed:

%exclude %{_usr}/lib/debug/*

Debug files are automatically picked up by the debug packages.

Comment 7 Alain V. 2018-08-31 10:14:20 UTC
I propose those modifications in .spec file:

1. licenses breakdown: Add this comment line before the License: tag
# For a license breakdown info, please refer to https://metadata.ftp-master.debian.org/changelogs/main/p/pcb-rnd/pcb-rnd_2.0.0-1_copyright

2. Delete the line 
%exclude %{_usr}/lib/debug/*

3. Use %{_prefix} instead of %{_usr} : I can't => No change.
Cause %{_usr}/lib/pcb-rnd  will become  %{_prefix}/lib/pcb-rnd  which in turn wants to be replaced by  %{_libdir}/pcb-rnd  which is /usr/lib64/... on 64bit system (obviously NOT /usr/lib/... !)

Now, please find in 
http://repo.hu/projects/pcb-rnd/developer/packaging/lib64.txt
why we don't want to install the plugins elsewhere



What will be the next step ? Thanks for your help.
Best regards
Alain

Comment 8 Robert-André Mauchin 🐧 2018-08-31 15:45:59 UTC
(In reply to Alain V. from comment #7)
> I propose those modifications in .spec file:
> 
> 1. licenses breakdown: Add this comment line before the License: tag
> # For a license breakdown info, please refer to
> https://metadata.ftp-master.debian.org/changelogs/main/p/pcb-rnd/pcb-rnd_2.0.
> 0-1_copyright
> 
> 2. Delete the line 
> %exclude %{_usr}/lib/debug/*
> 
> 3. Use %{_prefix} instead of %{_usr} : I can't => No change.
> Cause %{_usr}/lib/pcb-rnd  will become  %{_prefix}/lib/pcb-rnd  which in
> turn wants to be replaced by  %{_libdir}/pcb-rnd  which is /usr/lib64/... on
> 64bit system (obviously NOT /usr/lib/... !)
> 

That doesn't make any sense, why would %{_prefix}/lib/pcb-rnd become %{_libdir}/pcb-rnd?

Comment 9 Alain V. 2018-09-01 06:40:24 UTC
Sorry, I went too fast, did not mention the issue arises due to rpmlint error, so please, rewind:

pcb-rnd.spec file, line 3, if I change %{_usr} to become %{_prefix}, line 3 reads now:
%global plugindir             %{_prefix}/lib/%{name}/plugins

then rpmlint complains with an error:
pcb-rnd.spec:3: E: hardcoded-library-path in %{_prefix}/lib/%{name}/plugins

When I wanted to solve this error (in rpmlint terms), the Fedora packaging documentation instructs me to use the %{_libdir} macro which is expanded as "lib64" on 64-bit system, and not as "lib" as I wish...

So, I should keep the current macro as 
%global plugindir             %{_usr}/lib/%{name}/plugins


My conclusion is still the same: I wish to install plugins files in /usr/lib/pcb-rnd/plugins dir, and no other place, whatever arch.

HTH
Alain

Comment 10 Robert-André Mauchin 🐧 2018-09-01 08:49:08 UTC
> then rpmlint complains with an error: pcb-rnd.spec:3: E: hardcoded-library-path in %{_prefix}/lib/%{name}/plugins

The rpmlint error doesn't matter, we can choose to ignore it.

Comment 11 Alain V. 2018-09-01 09:14:03 UTC
I would have done so if only a warning was generated. I thought an error was not negligible, and made every effort to have no error, no warning with rpmlint.

You say: better have an error, but use %{_prefix} ? (BTW, this will generate 4 errors, because there are 4 places in the file, where this apply).

If yes, I will correct the .spec file during my next dev. slot, somewhere next week (don't have time to rebuild COPR at the moment).

Still: What will be the next step ?

Comment 12 Robert-André Mauchin 🐧 2018-09-01 09:18:03 UTC
Yes, rpmlint is not a perfect tool, sometimes it says there are errors when it is in fact acceptable.

Comment 13 Robert-André Mauchin 🐧 2018-09-01 12:20:36 UTC
No need for Copr, just show me the updated SPEC.

The next step for you is to find a sponsor, introduce yourself to the devel mailing list and do informait reviews to show that you understand the guidelines. Post link to your informal reviews here so a sponsor can see them.

Comment 14 Robert-André Mauchin 🐧 2018-09-19 15:16:49 UTC
The package is approved.

Comment 15 Gwyn Ciesla 2018-10-19 13:11:34 UTC
(fedscm-admin):  The Pagure repository was created at https://src.fedoraproject.org/rpms/pcb-rnd

Comment 16 Alain V. 2018-11-25 17:55:34 UTC
Upstream releases a new version.
I changed the .spec file, generate a srpm file, then perform again

$ fedpgk import <newfile.src.rpm>

This creates a tar.gz file in my git dir, and I did commit this file.
https://src.fedoraproject.org/rpms/pcb-rnd/blob/master/f/pcb-rnd-2.1.0.tar.gz

I think this is wrong, so:
1. Can I git delete / push   this tar.gz file ? Other action ?
2. It is not a fedpkg import command to use ? fedpkg new-sources ? How ?
3. Is there a documentation related to these maintenance actions ?

Thanks for your help.
Alain


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