Bug 427484

Summary: Review Request: publican-redhat - Red Hat theme
Product: [Fedora] Fedora Reporter: Jeff Fearn 🐞 <jfearn>
Component: Package ReviewAssignee: Nick Bebout <nb>
Status: CLOSED CURRENTRELEASE QA Contact: Fedora Extras Quality Assurance <extras-qa>
Severity: medium Docs Contact:
Priority: medium    
Version: rawhideCC: akurtako, fedora-package-review, kwade, nb, notting, paul, petersen, rfontana, rlandman+disabled, rlandman
Target Milestone: ---Keywords: Reopened
Target Release: ---Flags: nb: fedora-review+
kevin: fedora-cvs+
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2010-10-07 22:56:04 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:
Bug Depends On: 427482    
Bug Blocks:    

Comment 1 Karsten Wade 2008-01-14 17:00:33 UTC
I didn't run rpmlint to see if it dinged the license, but the license in the
spec file (OPL + restrictions) is not allowed in Fedora:

http://fedoraproject.org/wiki/Licensing

For what reason are you using the optional restrictions?  All the Red Hat
branding is already protected by trademark.


Comment 2 Jeff Fearn 🐞 2008-01-17 00:44:40 UTC
(In reply to comment #1)
> I didn't run rpmlint to see if it dinged the license, but the license in the
> spec file (OPL + restrictions) is not allowed in Fedora:
> 
> http://fedoraproject.org/wiki/Licensing
> 
> For what reason are you using the optional restrictions?  All the Red Hat
> branding is already protected by trademark.

The main goal here is to allow Red Hat writers and developers to use Fedora as
their main work environment for documentation.

The Red Hat documentation uses the above license. The xml & images in this
package is embedded in the books at build time. I thought it easiest to use the
same license to avoid licensing conflicts ... some may read that as "not have to
talk to lawyers" :D

I need a license that allows the xml and images to be used in OPL + Restrictions
books.



Comment 3 Karsten Wade 2008-01-18 05:01:49 UTC
(In reply to comment #2)
 
> The main goal here is to allow Red Hat writers and developers to use Fedora as
> their main work environment for documentation.

Which is, ironically, an argument for freeing Red Hat documentation from the
additional OPL restrictions.
 
> The Red Hat documentation uses the above license. The xml & images in this
> package is embedded in the books at build time. I thought it easiest to use the
> same license to avoid licensing conflicts ... some may read that as "not have to
> talk to lawyers" :D

The lawyers have already spoken, and thus we have:

http://fedoraproject.org/wiki/Licensing

FWIW, we just had a test case of this recently.  Several guides that went with
system-config-* packages and the PHP Manual were under the OPL with options. 
The result is the former changed their license, and the PHP Manual is not going
to appear in Fedora 9 because upstream did not want to change or dual-license.

> I need a license that allows the xml and images to be used in OPL + Restrictions
> books.

If Red Hat is the original copyright holder, they can dual-license under the OPl
without options.


Comment 4 Jeff Fearn 🐞 2008-01-18 05:41:43 UTC
I'll also get some to ask the lawyers if OPL licensed material can be included
in OPL + restrictions stuff.

Comment 5 Jeff Fearn 🐞 2008-09-17 22:50:58 UTC
No one is bugging me for this one either.

Comment 6 Ruediger Landmann 2010-07-12 03:11:29 UTC
> I didn't run rpmlint to see if it dinged the license, but the license in the
> spec file (OPL + restrictions) is not allowed in Fedora:

The package is now licensed CC-BY-SA, so this should no longer be a problem. Re-opening request

New spec file:
https://fedorahosted.org/releases/p/u/publican/publican-redhat.spec

New SRPM:
http://rlandmann.fedorapeople.org/publican/publican-redhat-2.0-0.fc13.src.rpm

Comment 7 Nick Bebout 2010-07-25 19:48:30 UTC
publican-redhat.spec:22: W: unversioned-explicit-obsoletes documentation-devel-%{brand}
publican-redhat.spec:14: W: mixed-use-of-spaces-and-tabs (spaces: line 14, tab: line 5)

Please fix the mixed-use-of-spaces-and-tabs.  I don't think the unversioned-explicit-obsoletes is an issue. (However, someone correct me if I'm wrong).

More to come.

Comment 8 Nick Bebout 2010-07-25 19:56:35 UTC
[nb@newharmony01 noarch]$ rpmlint publican-redhat-2.0-0.fc13.noarch.rpm 
publican-redhat.noarch: W: incoherent-version-in-changelog 2.0 ['2.0-0.fc13', '2.0-0']
** Please fix the changelog

publican-redhat.noarch: W: obsolete-not-provided documentation-devel-RedHat
** Please add Provides: documentation-devel-RedHat if you are going to obsolete it

publican-redhat.noarch: E: version-control-internal-file /usr/share/publican/Common_Content/RedHat/xsl/.svn/text-base/html-single.xsl.svn-base
** Please remove the .svn directory in your spec

publican-redhat.noarch: W: hidden-file-or-dir /usr/share/publican/Common_Content/RedHat/xsl/.svn
publican-redhat.noarch: W: hidden-file-or-dir /usr/share/publican/Common_Content/RedHat/xsl/.svn
publican-redhat.noarch: E: version-control-internal-file /usr/share/publican/Common_Content/RedHat/xsl/.svn/text-base/html.xsl.svn-base
publican-redhat.noarch: E: version-control-internal-file /usr/share/publican/Common_Content/RedHat/xsl/.svn/text-base
publican-redhat.noarch: E: version-control-internal-file /usr/share/publican/Common_Content/RedHat/xsl/.svn/text-base/pdf.xsl.svn-base
publican-redhat.noarch: E: version-control-internal-file /usr/share/publican/Common_Content/RedHat/xsl/.svn/entries
1 packages and 0 specfiles checked; 5 errors, 4 warnings.

Comment 9 Paul Howarth 2010-07-26 09:40:19 UTC
(In reply to comment #7)
> publican-redhat.spec:22: W: unversioned-explicit-obsoletes
> documentation-devel-%{brand}
> publican-redhat.spec:14: W: mixed-use-of-spaces-and-tabs (spaces: line 14, tab:
> line 5)
> 
> Please fix the mixed-use-of-spaces-and-tabs.  I don't think the
> unversioned-explicit-obsoletes is an issue. (However, someone correct me if I'm
> wrong).

It's a problem if anyone ever wishes to introduce a package (with any version number) called documentation-devel-%{brand} in the future. It's not unheard of for packages to be renamed one way and then back to the original name, or completely new packages to be introduced with names that have been used for something else in the past, so best practice is to use a versioned obsolete such as:

Obsoletes: documentation-devel-%{brand} <= V-R

where V-R is the version/release (including the dist tag, if any) of the last build using the old name.

Comment 10 Ruediger Landmann 2010-07-27 19:31:51 UTC
Thanks Nick and Paul

New spec and srpm are here:

http://rlandmann.fedorapeople.org/publican/publican.spec

http://rlandmann.fedorapeople.org/publican/publican-redhat-2.0-1.fc13.src.rpm

I have 

* removed the .svn directories (oops -- very embarrassing!)
* specified Obsoletes:	documentation-devel-%{brand} <= 0.4-0
* specified Provides:	documentation-devel-%{brand}-%{version}-%{release}
* fixed the mixed use of tabs and spaces that I could find

However, rpmlint still warns:
* "obsolete-not-provided" and "unversioned-explicit-provides" -- it seems that it isn't parsing "documentation-devel-%{brand}-%{version}-%{release}", but as you can see, the obsolete is provided for, and the provides is indeed versioned
* it's still complaining about mixed use of spaces and tabs in the spec file: "mixed-use-of-spaces-and-tabs (spaces: line 22, tab: line 191)" -- however, there's certainly no spaces in line 22, and line 191 does not exist at all, so I'm not sure what else to do here.

Comment 11 Ruediger Landmann 2010-07-27 19:47:13 UTC
(In reply to comment #10)

> New spec and srpm are here:
> 

Sorry -- Spec URL is:

http://rlandmann.fedorapeople.org/publican/publican-redhat.spec

Comment 12 Ruediger Landmann 2010-07-27 19:55:13 UTC
(In reply to comment #10)

> * it's still complaining about mixed use of spaces and tabs in the spec file:
> "mixed-use-of-spaces-and-tabs (spaces: line 22, tab: line 191)" -- however,
> there's certainly no spaces in line 22, and line 191 does not exist at all, so
> I'm not sure what else to do here.    

Ah! Found and fixed -- no more warnings :)

Comment 13 Paul Howarth 2010-07-28 09:57:42 UTC
You should have:

Provides:	documentation-devel-%{brand} = %{version}-%{release}
Obsoletes:	documentation-devel-%{brand} <= 0.4-0

That should fix the complaints about provides and obsoletes.

However, I note that the original submission in this review is for documentation-devel-RedHat-0.4-0.fc9, which is a higher release number (with the dist tag) than 
documentation-devel-RedHat-0.4-0. So I'd change the obsolete to:

Obsoletes:	documentation-devel-%{brand} < 0.4-1

Or maybe even:

Obsoletes:	documentation-devel-%{brand} < %{version}-%{release}

Comment 14 Ruediger Landmann 2010-07-28 22:50:39 UTC
Many thanks Paul -- that does indeed fix the problems! :)

New spec and SRPM:

http://rlandmann.fedorapeople.org/publican/publican-redhat.spec

http://rlandmann.fedorapeople.org/publican/publican-redhat-2.0-2.fc13.src.rpm

I've also made the same changes to the other Publican brand package currently up for review (JBoss) -- https://bugzilla.redhat.com/show_bug.cgi?id=427483

Comment 15 Nick Bebout 2010-08-11 23:20:07 UTC
[nb@sanjose01 SPECS]$ rpmlint publican-redhat.spec 
0 packages and 1 specfiles checked; 0 errors, 0 warnings.
[nb@sanjose01 SRPMS]$ rpmlint publican-redhat-2.0-2.fc13.src.rpm 
1 packages and 0 specfiles checked; 0 errors, 0 warnings.

[nb@sanjose01 SOURCES]$ sha1sum publican-redhat-2.0.tgz 
9568e41e868fbf507777ed841e2cbc46ae7c4cae  publican-redhat-2.0.tgz
[nb@sanjose01 SOURCES]$ sha1sum publican-redhat-2.0.tgz.1
9568e41e868fbf507777ed841e2cbc46ae7c4cae  publican-redhat-2.0.tgz.1

[YES] specfiles match
[YES] source files match upstream
[YES] package meets naming and versioning guidelines.
[YES] spec is properly named, cleanly written, and uses macros consistently.
[YES] dist tag is present.
[YES] build root is correct.
[YES] license field matches the actual license.
[YES] license is open source-compatible.
[YES] license text included in package.
[YES] latest version is being packaged.
[YES] BuildRequires are proper.
[YES] compiler flags are appropriate.
[YES] %clean is present. 
[YES] package builds in mock.
[YES] package installs properly.
[N/A] debuginfo package looks complete.
[YES] rpmlint is silent.
[YES] final provides and requires are sane
[N/A] %check is present and all tests pass:
[YES] no shared libraries are added to the regular linker search paths.
[YES] owns the directories it creates. 
[YES] doesn't own any directories it shouldn't.
[YES] no duplicates in %files.
[YES] file permissions are appropriate.
[YES] scriptlets match those on ScriptletSnippets page.
[YES] code, not content.
[YES] documentation is small, so no -docs subpackage is necessary.
[YES] %docs are not necessary for the proper functioning of the package.
[YES] no headers.
[YES] no pkgconfig files.
[YES] no libtool .la droppings.
[N/A] desktop files valid and installed properly.

Comment 16 Nick Bebout 2010-08-11 23:20:28 UTC
This package is APPROVED

Comment 17 Ruediger Landmann 2010-08-16 01:39:30 UTC
New Package SCM Request
=======================
Package Name: publican-redhat
Short Description: common files and templates needed to build documentation with the Red Hat brand with Publican.
Owners: jfearn rlandmann
Branches: f12 f13 f14
InitialCC:

Comment 18 Jason Tibbitts 2010-08-16 18:12:34 UTC
The bug summary says "publican-RedHat"; the requested package name is "publican-redhat".  Which did you actually want?  Please adjust either the SCM request or the bug summary so that they match.

Comment 19 Ruediger Landmann 2010-08-17 00:46:20 UTC
Thanks Jason -- publican-redhat is correct; summary adjusted accordingly

Comment 20 Kevin Fenzi 2010-08-17 21:00:50 UTC
Git done (by process-git-requests).

Comment 21 Nick Bebout 2010-08-31 23:32:44 UTC
Rudi, can you build this so we can resolve this bug?

Comment 22 Ruediger Landmann 2010-09-01 22:35:25 UTC
Thanks Nick -- I built and pushed this last week:

http://koji.fedoraproject.org/koji/buildinfo?buildID=190706

was there something else I needed to do in this bug?

Comment 23 Alexander Kurtakov 2010-10-07 13:20:15 UTC
(In reply to comment #22)
> Thanks Nick -- I built and pushed this last week:
> 
> http://koji.fedoraproject.org/koji/buildinfo?buildID=190706
> 
> was there something else I needed to do in this bug?

Yes, close it :)

Comment 24 Ruediger Landmann 2010-10-07 22:56:04 UTC
(In reply to comment #23)

> Yes, close it :)

Ah! Thanks :)