Bug 565603

Summary: Review Request: kitutuki - Shell script language
Product: [Fedora] Fedora Reporter: Mamoru TASAKA <mtasaka>
Component: Package ReviewAssignee: Matthew Kent <mkent>
Status: CLOSED NEXTRELEASE QA Contact: Fedora Extras Quality Assurance <extras-qa>
Severity: medium Docs Contact:
Priority: medium    
Version: rawhideCC: fedora-package-review, mkent, notting, rz
Target Milestone: ---Flags: mkent: fedora-review+
j: fedora-cvs+
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2010-02-19 20:52:47 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:

Description Mamoru TASAKA 2010-02-15 18:10:26 UTC
Spec URL: http://mtasaka.fedorapeople.org/Review_request/kitutuki/kitutuki.spec
SRPM URL: http://mtasaka.fedorapeople.org/Review_request/kitutuki/kitutuki-0.9.1-1.fc.src.rpm
Description: 
Kitutuki is a shell script language.

Koji scratch build
For F-13: http://koji.fedoraproject.org/koji/taskinfo?taskID=1988710
For F-12: http://koji.fedoraproject.org/koji/taskinfo?taskID=1988714

* This is needed for updating mfiler3 to 3.0.0.

Comment 1 Matthew Kent 2010-02-16 07:05:54 UTC
Will review tomorrow.

Comment 2 Matthew Kent 2010-02-17 07:26:57 UTC
Quick initial notes:

- License - the included file says it's GPLv2
- rpmlint complains of a missing BuildRoot tag
- As per http://fedoraproject.org/wiki/Packaging/Guidelines#Configuration_files can you add a note about why kitutuki.ksh is %config instead of %config(noreplace)

Questions:

As per http://fedoraproject.org/wiki/Packaging/Guidelines#Summary_and_description would it make sense to include a Japanese summary/description as I see done in another package you maintain http://cvs.fedoraproject.org/viewvc/rpms/eb/devel/eb.spec?revision=1.6&view=markup

--- 

Could the english summary/description be improved a bit - they don't say much about the usefulness of the software.

---

usage.en.txt is a bit sparse and I'm having trouble figuring out how to best use/test this. Would it be possible to either include a README.fedora with some english usage examples or perhaps a google translated version of usage.ja.txt (http://translate.google.ca/translate?hl=en&sl=ja&tl=en&u=http%3A%2F%2Fmagoazul.com%2Fusage.ja.txt)? I'm unsure on the Fedora policies here but it might be better than nothing.

---

I ran README.ja.txt through a google translation (http://translate.google.ca/translate?u=http%3A%2F%2Fmagoazul.com%2FREADME.ja.txt&sl=ja&tl=en&hl=&ie=UTF-8) and it tells me to try kitutuki_help:

mkent /misc/desktop > kitutuki_help
which: no lv in (/usr/kerberos/sbin:/usr/kerberos/bin:/usr/local/bin:/bin:/usr/bin:/usr/local/sbin:/usr/sbin:/sbin:/misc/desktop/bin:/misc/desktop/.gem/ruby/1.8/bin)
/usr/share/doc/kitutuki/usage.en.txt: No such file or directory

but it's searching the wrong path for usage.en.txt and is missing "lv". After installing lv:

mkent /misc/desktop > kitutuki_help
run time err
kitutuki.ksh 237: index -> invalid option number

Comment 3 Mamoru TASAKA 2010-02-17 08:02:06 UTC
Thank you for reviewing this.

(In reply to comment #2)
> Quick initial notes:
> - License - the included file says it's GPLv2
- (On Fedora) just putting GPLv2 license text into the tarball
  does not mean that it is under GPLv2, rather it is under GPL+
  https://fedoraproject.org/wiki/Licensing/FAQ#How_do_I_figure_out_what_version_of_the_GPL.2FLGPL_my_package_is_under.3F

> - rpmlint complains of a missing BuildRoot tag
- I explicitly removed this because BuildRoot is no longer used.

> - As per http://fedoraproject.org/wiki/Packaging/Guidelines#Configuration_files
> can you add a note about why kitutuki.ksh is %config instead of
> %config(noreplace)
- Will add in the next "release" (because kitutuki.ksh format may
  change in the next version as this package is uttely new package,
  for now I think replacing this file completely when upgrading
  version is much safer).

> Questions:
> 
> As per
> http://fedoraproject.org/wiki/Packaging/Guidelines#Summary_and_description
> would it make sense to include a Japanese summary/description as I see done in
> another package you maintain
> http://cvs.fedoraproject.org/viewvc/rpms/eb/devel/eb.spec?revision=1.6&view=markup

- Will add Japanese summary/description in the next "release".

> Could the english summary/description be improved a bit - they don't say much
> about the usefulness of the software.
- Unfortunately the upstream does not explain this so much
  (the main purpose of this package is to be used by mfiler3 of next version
   - a CUI file manager developed by the same author )

> usage.en.txt is a bit sparse and I'm having trouble figuring out how to best
> use/test this. Would it be possible to either include a README.fedora with some
> english usage examples or perhaps a google translated version of usage.ja.txt
> (http://translate.google.ca/translate?hl=en&sl=ja&tl=en&u=http%3A%2F%2Fmagoazul.com%2Fusage.ja.txt)?
> I'm unsure on the Fedora policies here but it might be better than nothing.
- Maybe I do when I have some time... however I don't want to translate
  usage.ja.txt by myself.

> I ran README.ja.txt through a google translation
> (http://translate.google.ca/translate?u=http%3A%2F%2Fmagoazul.com%2FREADME.ja.txt&sl=ja&tl=en&hl=&ie=UTF-8)
> and it tells me to try kitutuki_help:
> 
> mkent /misc/desktop > kitutuki_help
> which: no lv in
> (/usr/kerberos/sbin:/usr/kerberos/bin:/usr/local/bin:/bin:/usr/bin:/usr/local/sbin:/usr/sbin:/sbin:/misc/desktop/bin:/misc/desktop/.gem/ruby/1.8/bin)
> /usr/share/doc/kitutuki/usage.en.txt: No such file or directory
> 
> but it's searching the wrong path for usage.en.txt and is missing "lv". After
> installing lv:
> 
> mkent /misc/desktop > kitutuki_help
> run time err
> kitutuki.ksh 237: index -> invalid option number    
- I didn't notice this. Will fix in the next "release".

Comment 4 Mamoru TASAKA 2010-02-17 08:44:21 UTC
(In reply to comment #3)
> > I ran README.ja.txt through a google translation
> > (http://translate.google.ca/translate?u=http%3A%2F%2Fmagoazul.com%2FREADME.ja.txt&sl=ja&tl=en&hl=&ie=UTF-8)
> > and it tells me to try kitutuki_help:
> > 
> > mkent /misc/desktop > kitutuki_help
> > which: no lv in
> > (/usr/kerberos/sbin:/usr/kerberos/bin:/usr/local/bin:/bin:/usr/bin:/usr/local/sbin:/usr/sbin:/sbin:/misc/desktop/bin:/misc/desktop/.gem/ruby/1.8/bin)

- Well, I decided not to fix this error messages (lv is not needed
  by default)

> > /usr/share/doc/kitutuki/usage.en.txt: No such file or directory
- This one is fixed
  By the way for non-Japanese people kitutuki_help only shows
  usage.en.txt, which seems not so useful...

http://mtasaka.fedorapeople.org/Review_request/kitutuki/kitutuki-0.9.1-2.fc.src.rpm
http://mtasaka.fedorapeople.org/Review_request/kitutuki/kitutuki.spec

* Wed Feb 17 2010 Mamoru Tasaka <mtasaka.u-tokyo.ac.jp> - 0.9.1-2
- Add Japanese summary / description
- Add more comments about kitutuki.ksh
- Fix kitutuki.ksh for kitutuki_help

Comment 5 Matthew Kent 2010-02-17 08:56:26 UTC
(In reply to comment #3)
> Thank you for reviewing this.
> 
> (In reply to comment #2)
> > Quick initial notes:
> > - License - the included file says it's GPLv2
> - (On Fedora) just putting GPLv2 license text into the tarball
>   does not mean that it is under GPLv2, rather it is under GPL+
>  
> https://fedoraproject.org/wiki/Licensing/FAQ#How_do_I_figure_out_what_version_of_the_GPL.2FLGPL_my_package_is_under.3F
> 

Thanks for this - wasn't aware. 

Ah and I see GPL in the README.ja.txt now that I look closer.

> > - rpmlint complains of a missing BuildRoot tag
> - I explicitly removed this because BuildRoot is no longer used.
> 

Wasn't aware - thanks.

----

Package is well organized, compiles and functions. I don't see any blockers.

--------------------------------------------------------
  This package (kitutuki) is approved by mkent
--------------------------------------------------------

Comment 6 Mamoru TASAKA 2010-02-17 10:16:49 UTC
Thank you for a prompt review!

New Package CVS Request
=======================
Package Name:        kitutuki
Short Description:   Shell script language
Owners:              mtasaka
Branches:            F-11 F-12 F-13
InitialCC:

Comment 7 Richard Z. 2010-02-17 13:58:40 UTC
Looks ok, as it is a rather new thing could you please make the description a little more verbose. Like what goals does the scripting language try to achieve, what syntax does it (try to) follow or resemble most closely.

Comment 8 Mamoru TASAKA 2010-02-17 14:18:30 UTC
See my previous comments.

Comment 9 Matthew Kent 2010-02-18 17:30:09 UTC
(In reply to comment #8)
> See my previous comments.    

Maybe you could ask the upstream author for a better description?

Comment 10 Jason Tibbitts 2010-02-19 20:06:59 UTC
CVS done (by process-cvs-requests.py).

Comment 11 Fedora Update System 2010-02-19 20:49:26 UTC
kitutuki-0.9.3-1.fc13 has been submitted as an update for Fedora 13.
http://admin.fedoraproject.org/updates/kitutuki-0.9.3-1.fc13

Comment 12 Fedora Update System 2010-02-19 20:50:07 UTC
kitutuki-0.9.3-1.fc12 has been submitted as an update for Fedora 12.
http://admin.fedoraproject.org/updates/kitutuki-0.9.3-1.fc12

Comment 13 Fedora Update System 2010-02-19 20:50:48 UTC
kitutuki-0.9.3-1.fc11 has been submitted as an update for Fedora 11.
http://admin.fedoraproject.org/updates/kitutuki-0.9.3-1.fc11

Comment 14 Mamoru TASAKA 2010-02-19 20:52:47 UTC
Rebuilt for all branches, submitted push requests on bodhi, closing.
I will ask the upstream to make description verbose later.

Thank you for your review and cvs procedure.

Comment 15 Fedora Update System 2010-02-20 03:48:48 UTC
kitutuki-0.9.3-1.fc13 has been pushed to the Fedora 13 stable repository.  If problems still persist, please make note of it in this bug report.

Comment 16 Fedora Update System 2010-02-20 07:35:26 UTC
kitutuki-0.9.3-1.fc12 has been pushed to the Fedora 12 stable repository.  If problems still persist, please make note of it in this bug report.

Comment 17 Fedora Update System 2010-02-23 05:34:48 UTC
kitutuki-0.9.3-1.fc11 has been pushed to the Fedora 11 stable repository.  If problems still persist, please make note of it in this bug report.