Bug 507916 - Review Request: javanotes - Introduction to Programming Using Java, By David J. Eck
Summary: Review Request: javanotes - Introduction to Programming Using Java, By David ...
Keywords:
Status: CLOSED ERRATA
Alias: None
Product: Fedora
Classification: Fedora
Component: Package Review
Version: rawhide
Hardware: All
OS: Linux
medium
medium
Target Milestone: ---
Assignee: Jason Tibbitts
QA Contact: Fedora Extras Quality Assurance
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2009-06-24 17:30 UTC by steve
Modified: 2009-07-19 10:24 UTC (History)
3 users (show)

Fixed In Version: 5.1-2.fc10
Clone Of:
Environment:
Last Closed: 2009-07-19 10:08:35 UTC
Type: ---
Embargoed:
j: fedora-review+
kevin: fedora-cvs+


Attachments (Terms of Use)

Description steve 2009-06-24 17:30:07 UTC
Spec URL: http://lonetwin.net/yum/SPECS/javanotes.spec
SRPM URL: http://lonetwin.net/yum/SRPMS/javanotes-5.1-1.fc10.src.rpm
Description:

The fifth edition of Introduction to Programming Using Java, a free, on-line
textbook on introductory programming, which uses Java as the language of
instruction. This book is directed mainly towards beginning programmers,
although it might also be useful for experienced programmers who want to learn
something about Java. It is certainly not meant to provide complete coverage of
the Java language.

This is the html version, start with index.html in the main directory.

Comment 1 Susi Lehtola 2009-06-24 18:08:02 UTC
License version is not mentioned in
http://fedoraproject.org/wiki/Licensing

so tagging FE-LEGAL for now.

Comment 2 steve 2009-06-24 22:34:47 UTC
Updated the License tag based on Spot's comment about License version nos.
https://www.redhat.com/archives/fedora-packaging/2009-June/msg00108.html

New spec and srpm are at:
Spec URL: http://lonetwin.net/yum/SPECS/javanotes.spec
SRPM URL: http://lonetwin.net/yum/SRPMS/javanotes-5.1-1.fc10.src.rpm

Comment 3 Susi Lehtola 2009-06-25 07:25:22 UTC
Removing FE-LEGAL.

Comment 4 steve 2009-06-25 21:18:38 UTC
Made a minor change -- removed the dist tag, since it doesn't really serve any purpose for this rpm (same as the reasoning in bz 507915). Newer spec and srpm are at:
Spec URL: http://lonetwin.net/yum/SPECS/javanotes.spec
SRPM URL: http://lonetwin.net/yum/SRPMS/javanotes-5.1-1.src.rpm

Comment 5 Jason Tibbitts 2009-06-28 23:12:19 UTC
There's not much to this package.  You're right that the dist tag isn't necessary, but do keep in mind that not having it will not reduce download time as each release is signed with a different key (and hence the packages are different anyway), and you will be responsible for making sure that the release you push to F11 has a different version than what you push to F10 (and from what you push to devel).  But that's up to you; the dist tag only makes this convenient.  Just don't be surprised when you get "tag already exists" errors.

Packaging-wise there's not much to talk about; the package just unpacks a tarball and drops it under /usr/share/doc.  One issue that bothers me, though, is that the directory isn't versioned, unlike essentially every other directory in /usr/share/doc.  The package I'd compare this against, diveintopython, versions its directory.  Did you consider doing that?

* source files match upstream.  sha256sum:                         
   74f5c1a2525ea735f2f460dd36f416b6728ad7cdf4ef2d4a42a2d0e6686c5d43  
   javanotes5.tar.bz2
* package meets naming and versioning guidelines.
* specfile is properly named, is cleanly written and uses macros consistently.
* summary is OK.                                                              
* description is OK.                                                          
* build root is OK.                                                           
* license field matches the actual license.                                   
* license is open source-compatible.                                          
* license text not included upstream.                                         
* latest version is being packaged.                                           
* BuildRequires are proper (none).
* %clean is present.
* package builds in mock (rawhide, x86_64).
* package installs properly.
* rpmlint is silent.
* final provides and requires are sane:
   javanotes = 5.1-1
  =
   (none)
* owns the directories it creates.
* doesn't own any directories it shouldn't.
* no duplicates in %files.
* file permissions are appropriate.
* no generically named files.
* acceptable content.

The package review process needs reviewers!  If you haven't done any package
reviews recently, please consider doing one.

Comment 6 steve 2009-07-02 15:09:17 UTC
(In reply to comment #5)
> There's not much to this package.  You're right that the dist tag isn't
> necessary, but do keep in mind that not having it will not reduce download time
> as each release is signed with a different key (and hence the packages are
> different anyway), and you will be responsible for making sure that the release
> you push to F11 has a different version than what you push to F10 (and from
> what you push to devel).  But that's up to you; the dist tag only makes this
> convenient.  Just don't be surprised when you get "tag already exists" errors.
> 
I've added the dist tag back to the spec.

> Packaging-wise there's not much to talk about; the package just unpacks a
> tarball and drops it under /usr/share/doc.  One issue that bothers me, though,
> is that the directory isn't versioned, unlike essentially every other directory
> in /usr/share/doc.  The package I'd compare this against, diveintopython,
> versions its directory.  Did you consider doing that?
> 
Sounds reasonable. Done this too.

New spec and srpm are at:
Spec URL: http://lonetwin.net/yum/SPECS/javanotes.spec
SRPM URL: http://lonetwin.net/yum/SRPMS/javanotes-5.1-2.fc10.src.rpm

> The package review process needs reviewers!  If you haven't done any package
> reviews recently, please consider doing one.  
Sure, will pick at least a couple up.

thanks,
- steve

Comment 7 Jason Tibbitts 2009-07-03 23:02:07 UTC
FYI, another of your documentation packages seems to have spawned some discussion about the admissibility of, well, some class of documentation-only packages (or packages containing books) that nobody seems able to define but which this package seems to fall into.  The fact that nobody ever complained about diveintopython, or python-docs for that matter, was all the justification I needed to approve this, but this discussion has shown that it's at least prudent to wait to see what comes of the discussion.

So at this point I'd approve this if I knew the rules weren't going to change.  If nothing happens at the next FESCo meeting (on the 10th) then I'll move forward with this.  Unfortunately there was no meeting today due to the US independence holiday.

Comment 8 Jason Tibbitts 2009-07-12 20:15:42 UTC
Looks like the person making the stink about this didn't end up submitting his arguments to FESCo.  In the meantime there's an entire documentation effort writing books like fedora-security-guide which are being included into the distribution without argument.  So honestly I can't see any reason why this package wouldn't be similarly OK.

APPROVED

Comment 9 steve 2009-07-13 10:19:24 UTC
Hi Jason,

Thanks for your time !

Could you also please review and approve bug #507912 ?

- steve

Comment 10 steve 2009-07-13 10:20:35 UTC
New Package CVS Request
=======================
Package Name: javanotes
Short Description: Introduction to Programming Using Java, By David J. Eck
Owners: lonetwin
Branches: F-10 F-11
InitialCC:

Comment 11 Kevin Fenzi 2009-07-14 04:45:11 UTC
cvs done.

Comment 12 Fedora Update System 2009-07-14 12:58:30 UTC
javanotes-5.1-2.fc10 has been submitted as an update for Fedora 10.
http://admin.fedoraproject.org/updates/javanotes-5.1-2.fc10

Comment 13 Fedora Update System 2009-07-14 13:04:22 UTC
javanotes-5.1-2.fc11 has been submitted as an update for Fedora 11.
http://admin.fedoraproject.org/updates/javanotes-5.1-2.fc11

Comment 14 Fedora Update System 2009-07-19 10:08:30 UTC
javanotes-5.1-2.fc11 has been pushed to the Fedora 11 stable repository.  If problems still persist, please make note of it in this bug report.

Comment 15 Fedora Update System 2009-07-19 10:24:39 UTC
javanotes-5.1-2.fc10 has been pushed to the Fedora 10 stable repository.  If problems still persist, please make note of it in this bug report.


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